home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / programs / psys051.zip / PEGASYS.DOC < prev    next >
Text File  |  1992-07-29  |  278KB  |  6,773 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.       PegaSys Bulletin Board System - Version 0.43 Standard
  24.       Copyright (C) 1991-92, CompuMark Technology.
  25.       All Rights Reserved.
  26.  
  27.       Main Documentation
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                PegaSys Bulletin Board System Version 0.43 Standard
  54.           Copyright 1991-92, CompuMark Technology. All Rights Reserved.
  55.  
  56.  
  57.      No  part  of  this publication may be  reproduced  without  the  prior
  58.      written consent of the copyright holders.  All brand and product names
  59.      mentioned in this publication are trademarks or registered  trademarks
  60.      of their respective copyright holders.
  61.  
  62.                       ___________________________________
  63.  
  64.                        T A B L E   O F   C O N T E N T S
  65.                       ___________________________________
  66.  
  67.  
  68.      Introduction ..................................................... 1
  69.         Installing a New System ....................................... 1
  70.         Updated Releases .............................................. 1
  71.         Warranty and Copyright Information ............................ 2
  72.         Additional Information and Help ............................... 2
  73.      System Startup and the WFC Screen ................................ 3
  74.      SysOp Function Keys .............................................. 7
  75.      The ACS System ................................................... 10
  76.      The MCI Code System .............................................. 13
  77.         MCI Codes for Prompts ......................................... 13
  78.         MCI Codes for Door Commands ................................... 14
  79.         MCI Codes for Messages and Text Files ......................... 15
  80.         MCI Color Codes ............................................... 16
  81.      System Configuration ............................................. 17
  82.         Modem Configuration ........................................... 18
  83.         File Paths & BBS Configuration ................................ 21
  84.         System ACS Settings ........................................... 24
  85.         General Variables ............................................. 26
  86.         General Flagged Functions ..................................... 29
  87.         File Section Configuration .................................... 33
  88.            Archive Configuration ...................................... 35
  89.         New User & Auto-Validation Settings ........................... 38
  90.         Miscellaneous Configuration ................................... 41
  91.         Network Configuration ......................................... 42
  92.         Language Editor ............................................... 45
  93.         Default Colors ................................................ 50
  94.         Time Limitations .............................................. 51
  95.         Call Allowances Per Day ....................................... 52
  96.         UL/DL Number of Files Ratio ................................... 52
  97.         UL/DL Kilobytes Ratio ......................................... 52
  98.      Modem Information ................................................ 53
  99.         Sample Initialization Strings ................................. 53
  100.         High-Speed Modems ............................................. 53
  101.            The US Robotics Dual Standard Modem ........................ 54
  102.         Using a FOSSIL Communications Driver .......................... 54
  103.            The History of FOSSIL ...................................... 55
  104.            How a FOSSIL Driver Benefits PegaSys ....................... 56
  105.            Installing a FOSSIL Driver With PegaSys .................... 56
  106.      The User Editor .................................................. 57
  107.      The File Base Editor ............................................. 62
  108.      The Message Base Editor .......................................... 67
  109.      The Protocol Editor .............................................. 73
  110.      The Menu Editor .................................................. 79
  111.         The Main Editor Menu .......................................... 79
  112.         Menu Command Modification ..................................... 81
  113.         Menu Information Modification ................................. 83
  114.         Special Global Menu Commands .................................. 85
  115.         The Help-File Menu System ..................................... 86
  116.         The Generic Menu System ....................................... 88
  117.         Linking Menu Commands ......................................... 89
  118.         Menu Commands Available in PegaSys ............................ 90
  119.  
  120.  
  121.  
  122.  
  123.      The Scheduled Event Editor ....................................... 91
  124.      Pega-DOS ......................................................... 95
  125.         Pega-DOS Commands ............................................. 95
  126.         The Pega-DOS Text Editor ...................................... 97
  127.      The InfoForm Questionnaire System ................................ 99
  128.         How InfoForm Questionnaires Are Constructed ................... 99
  129.         The New User Questionnaire .................................... 99
  130.         Asking and Reading InfoForm Questionnaires .................... 99
  131.         InfoForm Questionnaire Commands ............................... 100
  132.         A Sample InfoForm Questionnaire ............................... 101
  133.      Run-Time Errors .................................................. 103
  134.         DOS Errors .................................................... 104
  135.         I/O Errors .................................................... 104
  136.         Critical Errors ............................................... 104
  137.         Fatal Errors .................................................. 105
  138.         Registering PegaSys ........................................... 106
  139.  
  140.                    PegaSys Main Documentation - Version 0.43
  141.  
  142.  
  143.                                  ______________
  144.  
  145.                                   INTRODUCTION
  146.                                  ______________
  147.  
  148.  
  149.      Thank  you for choosing PegaSys  as your bulletin board  system  (BBS)
  150.      software  of  choice.   We  feel  that  PegaSys   represents  the  BBS
  151.      community  as a nice, user friendly software package that is  easy  to
  152.      set up, yet powerful enough to set it apart from other software in its
  153.      class.
  154.  
  155.      PegaSys   was  written and compiled using the Turbo  Pascal  compiler,
  156.      version  5.5,  from Borland International.  Main testing was  provided
  157.      by Vigilante, Supreme Ruler, and Falcon.
  158.  
  159.  
  160.      -----------------------
  161.      INSTALLING A NEW SYSTEM
  162.      -----------------------
  163.  
  164.      PegaSys   was  designed to be used with the following  minimum  system
  165.      configuration:
  166.  
  167.           -    IBM PC/XT/AT (or true compatible) or PS/2
  168.           -    Hard disk drive (10 megabytes minimum)
  169.           -    384K RAM (more is preferable)
  170.           -    80 column monochrome or color monitor
  171.           -    Modem (300 baud or greater; Hayes compatible is preferred)
  172.           -    PC-DOS or MS-DOS version 3.2 or later
  173.  
  174.      A  start-up package is distributed under the name INITxxxx.ZIP,  where
  175.      "xxxx"  indicates  the  version  number  in  question.   This  archive
  176.      contains complete documentation concerning the setup of a new system.
  177.  
  178.  
  179.      ----------------
  180.      UPDATED RELEASES
  181.      ----------------
  182.  
  183.      Alpha  and Beta sites (as well as most Standard sites) will  have  the
  184.      latest  Standard release, and will distribute them at no  cost  (other
  185.      than  the  phone call to download the program!).   Hopefully,  updates
  186.      will  be  released on a regular basis, but we are unable to  give  any
  187.      kind of schedule.
  188.  
  189.      Since  Alpha  and  Beta sites perform testing  of  newer  versions  of
  190.      PegaSys  before it is released Standard, you might want to call  those
  191.      boards  to keep up with the latest features.  We are adding  them  all
  192.      the time!
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                                    - Page 1 -
  202.  
  203.                    PegaSys Main Documentation - Version 0.43
  204.  
  205.  
  206.      ------------------------
  207.      SOURCE CODE AVAILABILITY
  208.      ------------------------
  209.  
  210.      The  source code for PegaSys is  not available for the general  public
  211.      under any circumstances.  This may go "against the grain" of  seasoned
  212.      programmers,  but the PegaSys development team has had much trouble in
  213.      the  past with the source code "floating around," and doesn't want  to
  214.      repeat the same mistakes in the future.
  215.  
  216.      A  software  developer's toolkit will soon be available for Turbo
  217.      Pascal and Turbo C++ for anybody interested in writing utilities
  218.      for PegaSys.
  219.  
  220.  
  221.      ----------------------------------
  222.      WARRANTY AND COPYRIGHT INFORMATION
  223.      ----------------------------------
  224.  
  225.      PegaSys   is  not  public domain software; it is  copyrighted  by  the
  226.      PegaSys   development  team.   However,  we grant  you  the  right  to
  227.      distribute as many copies of the Standard release version as you wish,
  228.      provided the following restrictions are kept in mind:
  229.  
  230.           -    Only distribute the Standard release version in its original
  231.                form, with all of its related files intact.  We will allow
  232.                the archives to be converted to a different format, but that
  233.                is the extent of it.
  234.           -    Do not accept ANY kind of payment for the program.  The
  235.                exception would be computer clubs and other organizations
  236.                that charge a nominal price for disk copying, mailing, etc.
  237.           -    Do not alter the program in any manner.
  238.           -    Do not use the program in a commercial environment.  If you
  239.                wish to do so, contact the development team for
  240.                Commercial Registration rights.
  241.  
  242.      PegaSys  is guaranteed only to take up disk space.  No other  warranty
  243.      or responsibility is implied; the development team is not  responsible
  244.      for  damages  resulting  from  the use (or  misuse)  of  the   PegaSys
  245.      software.  In plain English:  It works for us, but if it doesn't  work
  246.      for  you... c'est la vie.  (Or, in other words "Tha's Life").
  247.  
  248.  
  249.      -------------------------------
  250.      ADDITIONAL INFORMATION AND HELP
  251.      -------------------------------
  252.  
  253.      Experiment; it's a big system, and you're not going to learn it all in
  254.      one sitting.  If you need help and/or information concerning the setup
  255.      and  operation  of  a  PegaSys  system, you may  contact  one  of  the
  256.      PegaSys   Alpha or Beta sites.  Since the installed base  of  PegaSys
  257.      systems  is growing by leaps and bounds, you should check the list  of
  258.      PegaSys   systems  (included with every Standard release) for  a  site
  259.      near you.
  260.  
  261.  
  262.                                    - Page 2 -
  263.  
  264.                    PegaSys Main Documentation - Version 0.43
  265.  
  266.  
  267.                       ___________________________________
  268.  
  269.                        SYSTEM STARTUP AND THE WFC SCREEN
  270.                       ___________________________________
  271.  
  272.  
  273.      To  start  the BBS, change to the main BBS directory and  execute  the
  274.      "BBS"  program.   Assuming  that  the  main  BBS  directory  is  named
  275.      "C:\BBS", you would type the following commands:
  276.  
  277.           CD C:\BBS
  278.           BBS
  279.  
  280.      Alternatively, you may place these commands into a batch file, and use
  281.      the batch file to start the BBS.  This has several advantages, not the
  282.      least  of  which  is  the ability to  interpret  the  ERRORLEVEL  code
  283.      returned  from  the program.  Normal termination, critical  errors  or
  284.      external system events can be identified and appropriate action taken,
  285.      depending  on  the  ERRORLEVEL value.
  286.  
  287.      There  are also several command line options you can use to alter  the
  288.      functioning  of  the system.  These options can be entered  in  either
  289.      upper or lower case:
  290.  
  291.           -Bxxxxx   Answer the phone and force the baud rate to "xxxxx".
  292.                     Note that the "answer phone" string is NOT sent to the
  293.                     modem.  This option will find the most use when
  294.                     executing the system from a front-end mailer (refer to
  295.                     "Using PegaSys  With FidoNet" for more information).
  296.           -EExxx    If a critical error occurs during the operation of the
  297.                     BBS, it aborts to DOS with an ERRORLEVEL value of 254.
  298.                     This option can be used to change that value.
  299.           -ENxxx    Normally, when you perform a normal exit back to DOS,
  300.                     the program returns an ERRORLEVEL value of 255.  This
  301.                     option can be used to change that value.
  302.           -K        Operate the BBS in local mode only (don't send anything
  303.                     out to the modem, and don't respond to incoming calls).
  304.           -P        Pack the message bases and return to DOS.  This option
  305.                     can be useful when using PegaSys  with a front-end
  306.                     mailer (refer to "Using PegaSys  With FidoNet");
  307.                     message base packing can be performed from the command
  308.                     line during a front-end event.  Thus, you don't have to
  309.                     mess around with two event systems (you can perform all
  310.                     external events through the front-end if you like).
  311.           -Q        Quit to DOS after the next user logs off.
  312.  
  313.      PegaSys   will then perform various initialization functions (such  as
  314.      loading data files and initializing the modem) before arriving at  the
  315.      Wait  For Caller (WFC) screen.  The WFC screen is where the  BBS  sits
  316.      while  waiting for the next caller.  The commands available from  this
  317.      screen  are  displayed, as well as  the  following  constantly-updated
  318.      information:
  319.  
  320.           Time - The current time and date.
  321.           Mail - The number of Email messages the SysOp has waiting.
  322.           DLs - The number of files and kilobytes downloaded for the day.
  323.  
  324.  
  325.                                    - Page 3 -
  326.  
  327.                    PegaSys Main Documentation - Version 0.43
  328.  
  329.  
  330.           ULs - The number of files and kilobytes uploaded for the day.
  331.           % Activity - The percentage of activity for the day.
  332.           Disk Space - The total amount of remaining disk space.
  333.           Last Active - How long ago the BBS was last active.
  334.           Last Caller - The name of the last remote caller.
  335.  
  336.      The  commands  available from the WFC screen are explained  in  detail
  337.      below.   In most cases, there is a chapter in this manual  devoted  to
  338.      the  command in question (such as the message and file  base  editors,
  339.      and the system configuration command).
  340.  
  341.           A         Sends the "answer phone" command to the modem.  It is
  342.                     used mainly for situations where you have your system
  343.                     "hard-wired" to another system for testing purposes.
  344.                     In most cases, the BBS will automatically answer the
  345.                     phone by itself.
  346.  
  347.           B         Enters the message base editor, where you can enter and
  348.                     modify the bases used to store public messages.
  349.  
  350.           C         Displays a list of callers for the day.
  351.  
  352.           D         Shells to DOS, allowing you to perform maintenance and
  353.                     other functions that aren't available through Mini-DOS.
  354.                     To return to the WFC menu, use the DOS "EXIT" command.
  355.  
  356.           E         Enters the scheduled event editor, where you can enter
  357.                     and modify the various scheduled events used to perform
  358.                     system maintenance (and other functions).
  359.  
  360.           F         Enters the file base editor, where you can enter and
  361.                     modify the bases used to store files for uploading and
  362.                     downloading by users.
  363.  
  364.           G         Enters the text file base editor, where you can enter
  365.                     and modify the bases used to store user-viewable text
  366.                     (and ANSI) files, as well as add and delete entries in
  367.                     each base.
  368.  
  369.           H         Sends the "initialization" command to the modem, which
  370.                     serves to hang up the phone if it is offhook (usually
  371.                     via the "O" command).
  372.  
  373.           I         Enters the voting editor, where you can enter and
  374.                     modify the voting booth questions.
  375.  
  376.           L         Displays the SysOp logs.  You can display today's log,
  377.                     or the logs of previous days (up to the number of days
  378.                     specified in the system configuration).
  379.  
  380.           M         Allows viewing of ALL Email messages that have been
  381.                     posted.  It does not allow for the viewing of a
  382.                     specific individual's Email (use the "R" command for
  383.                     that).
  384.  
  385.  
  386.  
  387.  
  388.                                    - Page 4 -
  389.  
  390.                    PegaSys Main Documentation - Version 0.43
  391.  
  392.  
  393.           N         Enters the Mini-DOS text editor, allowing you to create
  394.                     and edit any text file in the AFILES directory.  (This
  395.                     editor is very similar to the DOS "EDLIN" editor.)
  396.  
  397.           O         Sends the "offhook" command to the modem, which makes
  398.                     the line busy to all remote callers.  Use the "H" or
  399.                     "+" commands to hang up the phone.
  400.  
  401.           P         Enters the system configuration, where you can perform
  402.                     most of the major changes and modifications to the BBS.
  403.  
  404.           Q         Exits the BBS and returns to DOS with the "normal
  405.                     exit" ERRORLEVEL value (discussed earlier).
  406.  
  407.           R         Allows you to read a specific individual's Email
  408.                     messages.
  409.  
  410.           S         Displays the current status of the BBS (chat status,
  411.                     number of users, etc.).
  412.  
  413.           T         If a batch file named "TERM.BAT" exists, PegaSys  will
  414.                     execute it.  This is mainly used to call an external
  415.                     terminal program (such as MiniTerm, which is available
  416.                     separately).
  417.  
  418.           U         Enters the user editor, where you can modify the
  419.                     modify the information for each user of the BBS.
  420.  
  421.           V         Creates a text file containing the current questions in
  422.                     the voting booth, along with the current statistics of
  423.                     each answer (percentages, who voted for which answer,
  424.                     etc.), which can optionally be displayed on the screen.
  425.  
  426.           W         Allows you to send Email messages to other users,
  427.                     either individually or via various mass mail criteria.
  428.  
  429.           X         Enters the protocol editor, where you can enter and
  430.                     modify the definitions of the file transfer protocols
  431.                     used to upload and download files.
  432.  
  433.           Z         Displays the usage log information contained in the
  434.                     ZLOG.DAT file, which contains a record of all general
  435.                     system activity (number of posts, number of uploads
  436.                     and downloads, etc.).
  437.  
  438.           #         Enters the menu editor, where you can create and modify
  439.                     the BBS online menus.
  440.  
  441.           !         Enters Mini-DOS, which is a DOS-like environment that
  442.                     can be used for system maintenance functions.  Unlike
  443.                     the full DOS shell, Mini-DOS has security restrictions
  444.                     on many of its commands.
  445.  
  446.           +         Sends the "initialization" command to the modem, used
  447.                     to initialize the modem.  (This also serves to hang up
  448.                     the phone if the line was taken offhook via the "O"
  449.  
  450.  
  451.                                    - Page 5 -
  452.  
  453.                    PegaSys Main Documentation - Version 0.43
  454.  
  455.  
  456.                     command.)
  457.  
  458.           [ESC]     Allows  you  to  log on to the BBS  locally.   You  can
  459.                     choose to log on normally (by pressing "Y") or log on
  460.                     quickly  (by  pressing "F").  Logging on  quickly  will
  461.                     bypass the shuttle logon menu, all the text and ANSI
  462.                     files, the auto-message, and the bulletin menu (some or
  463.                     all of which may already be disabled by you via the
  464.                     system configuration).
  465.  
  466.           1 to 9    Executes batch files called "WFCBATx.BAT", where "x" is
  467.                     the digit that you pressed (1 to 9).
  468.  
  469.      There  is  a  secondary  WFC screen that is  displayed  if  the  local
  470.      security  function  is  enabled in the  system  configuration;  it  is
  471.      called,  appropriately  enough, the WFC security  screen.   When  this
  472.      screen is displayed, only two commands are allowed:  [SPACE] and  "Q".
  473.      "Q"  will,  obviously, exit to DOS with the "normal  exit"  ERRORLEVEL
  474.      value.   Pressing  [SPACE]  will  bring up a  prompt  for  the  system
  475.      password;  entering the correct password will display the  normal  WFC
  476.      screen, allowing the use of all WFC menu commands.
  477.  
  478.      Note that both the normal and security WFC screens can be modified  to
  479.      suit  your taste.  The image of both of these screens is contained  in
  480.      two ANSI files, WFCMENU.ANS (the normal screen) and WFCMENU0.ANS  (the
  481.      security  screen).   Modifying one of these files  will  automatically
  482.      regenerate  the WFCMENU.DAT and WFCMENU0.DAT files (which contain  the
  483.      raw screen images), and will give your system a more customized look.
  484.  
  485.      Lines 1-23 of the security WFC screen, and lines 6-23 of the main  WFC
  486.      screen, are available for your images.  (Lines 24 and 25 are  reserved
  487.      for information that the BBS displays.)  Some further notes about  the
  488.      normal WFC screen:
  489.  
  490.           -    If you turn the WFC logo off in the system configuration,
  491.                lines 1-5 also become available for your images.
  492.  
  493.           -    Be careful of the portion of the screen that displays the
  494.                constantly updated information.  Make sure that whatever
  495.                image you create isn't affected by the information that will
  496.                be displayed.  For simplicity, it is suggested that you
  497.                leave that portion of the image alone (this is, of course,
  498.                entirely up to you).
  499.  
  500.      ANSI  files can be created using a Shareware program  called  TheDraw,
  501.      which is an ANSI picture editor and animator.  Look for TheDraw on one
  502.      of  the  BBSes  in your area; it is a  very  popular  program,  widely
  503.      regarded as the best in its class.  (It is usually under the  filename
  504.      "TDRAWxxx.ZIP"; the "xxx" depends on the current version number.)
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.                                    - Page 6 -
  515.  
  516.                    PegaSys Main Documentation - Version 0.43
  517.  
  518.  
  519.                              _____________________
  520.  
  521.                               SYSOP FUNCTION KEYS
  522.                              _____________________
  523.  
  524.  
  525.      There  are  many functions available to you via  function  keys,  both
  526.      while  a  user is online (or while you are online locally)  and  while
  527.      you're performing local maintenance.  These function keys are used  to
  528.      perform  maintenance, change a user's security information, and  other
  529.      operations.
  530.  
  531.      The following function keys are available only when a user is online:
  532.  
  533.           [F1]           Allows modification of the user's security
  534.                          information (SL, DSL, AR & AC flags, file points).
  535.                          Prints the "SysOp working" message while this
  536.                          window is displayed.
  537.  
  538.           [Shift-F1]     Same as [F1] except that the "SysOp working"
  539.                          message is not displayed.
  540.  
  541.           [F2]           Switches the SysOp information windows between the
  542.                          normal 5-line window and the extended 11-line
  543.                          window.  If the window is not on, [F2] will turn
  544.                          it on.
  545.  
  546.           [Shift-F2]     Toggles the SysOp window on and off.
  547.  
  548.           [F3]           Toggles the user's keyboard on and off.  This
  549.                          doesn't actually disable the user's keyboard, it
  550.                          only tells the system to ignore any keystrokes
  551.                          coming from the user (which has the EFFECT of
  552.                          disabling the user's keyboard).  Ever been in chat
  553.                          mode and couldn't get a word in edgewise?  This is
  554.                          the function key for you!
  555.  
  556.           [Shift-F3]     Toggles the user's screen on and off.  Again, this
  557.                          doesn't actually disable the user's screen, it
  558.                          only tells the system not to send any output to
  559.                          the user (which has the EFFECT of disabling the
  560.                          user's screen).
  561.  
  562.           [Alt-F3]       Toggles the local screen on and off.  Like
  563.                          [Shift-F3], it doesn't disable the screen, it only
  564.                          suspends output to the screen (which has the
  565.                          EFFECT of disabling the local screen).
  566.  
  567.           [F4]           Turns off the "user attempted to chat" flag
  568.                          (shown on the SysOp window as a blinking "-CHAT-"
  569.                          message).
  570.  
  571.           [Alt-F4]       Performs a local shell to DOS.  Prints the "SysOp
  572.                          has shelled to DOS" message before entering DOS,
  573.                          and the "thank you for waiting" message after
  574.                          returning from DOS.
  575.  
  576.  
  577.                                    - Page 7 -
  578.  
  579.                    PegaSys Main Documentation - Version 0.43
  580.  
  581.  
  582.           [Ctrl-F4]      Performs a "warm" reboot of the computer.  (A
  583.                          "warm" reboot skips the memory test and other
  584.                          self-checks normally associated with a first-time,
  585.                          or "cold" boot.)
  586.  
  587.           [F5]           Hangs up on a user immediately and returns to the
  588.                          WFC menu.
  589.  
  590.           [Shift-F5]     Allows you to select a hangup message to display
  591.                          (HANGUP0.MSG through HANGUP9.MSG) before hanging
  592.                          up on the user and returning to the WFC menu.
  593.  
  594.           [Alt-F5]       Prints fake "line noise" (random ASCII characters)
  595.                          before hanging up on the user and returning to
  596.                          the WFC menu.
  597.  
  598.           [Ctrl-F5]      Prints fake "line noise" but does NOT hang up on
  599.                          the user.  Used mainly to drive users crazy!  (Who
  600.                          says being a SysOp isn't fun?!)
  601.  
  602.           [F6]           Redraws the SysOp window, if active.
  603.  
  604.           [F7]           Subtracts five minutes from a user's total time
  605.                          left.
  606.  
  607.           [Shift-F7]     Subtracts a specified amount of time from a user's
  608.                          total time left.
  609.  
  610.           [F8]           Adds five minutes to a user's total time left.
  611.  
  612.           [Shift-F8]     Adds a specified amount of time to a user's total
  613.                          time left.
  614.  
  615.           [F9]           Toggles temporary SysOp access for a user.  If
  616.                          temporary SysOp access is still active when the
  617.                          user logs off, the user's statistics are returned
  618.                          to normal.  USE ONLY WITH TRUSTED USERS!!!
  619.  
  620.           [Alt-F9]       Sends a continuous stream of ASCII bell characters
  621.                          (7 decimal) to a user, which will produce a
  622.                          continuous stream of beeps until the user presses
  623.                          a key on his keyboard (or hangs up).  Used to get
  624.                          a daydreaming user's attention!
  625.  
  626.           [F10]          Toggles chat mode on and off, allowing you to
  627.                          "talk" to a user via the keyboard.
  628.  
  629.           [Shift-F10]    Toggles "beep-after-end" on and off.  This feature
  630.                          will, when activated, take the phone offhook and
  631.                          sound an alarm when the user logs off, thus
  632.                          letting you know that the system is available.
  633.  
  634.           [Alt][F10]     Displays the chat reason on the top line of the
  635.                          local screen.
  636.  
  637.  
  638.  
  639.  
  640.                                    - Page 8 -
  641.  
  642.                    PegaSys Main Documentation - Version 0.43
  643.  
  644.  
  645.           [Home]         Toggles the chat capture buffer on and off (used
  646.                          while in chat mode).
  647.  
  648.           [Alt-G]        Allows enabling and disabling of activity trapping
  649.                          and chat capturing for a user.
  650.  
  651.           [Alt-J]        An alternative to [Alt-F4] to shell to DOS.  The
  652.                          [Alt-J] sequence is the same one used by Telix and
  653.                          other communications programs to shell to DOS,
  654.                          thus it provides ease of use for SysOps that use
  655.                          those particular programs.
  656.  
  657.           [Alt-L]        Clears the local screen.  If the SysOp window is
  658.                          active, only the user area is cleared.
  659.  
  660.           [Alt-T]        Toggles the SysOp window display between the top
  661.                          and bottom of the local screen.
  662.  
  663.           [Alt-V]        Validates a user while he/she is online, using the
  664.                          validation settings specified in the system
  665.                          configuration.
  666.  
  667.      The  following  function keys are available anywhere  in  the  system,
  668.      whether or not a user is online:
  669.  
  670.           [Alt-=]        Toggles "DOS exit after user logoff" on and off.
  671.                          This means that the system will return to DOS
  672.                          after the current caller has logged off or, if
  673.                          toggled on while at the WFC menu (or elsewhere),
  674.                          when the NEXT caller has logged off.
  675.  
  676.           [Alt-x]        Executes a batch file called "GLOBATx.BAT", where
  677.                          "x" is a number from 1 to 9.
  678.  
  679.           [Scroll Lock]  Toggles the "SysOp available for chat" flag on and
  680.                          off.  When the [Scroll Lock] light on the keyboard
  681.                          is off, the SysOp is available; when the light is
  682.                          on, the SysOp is unavailable.
  683.  
  684.           [Ctrl]         Provides for an immediate exit from the BBS,
  685.           [Print Scrn]   returning the "critical error" ERRORLEVEL value.
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.                                    - Page 9 -
  704.  
  705.                    PegaSys Main Documentation - Version 0.43
  706.  
  707.  
  708.                                 ________________
  709.  
  710.                                  THE ACS SYSTEM
  711.                                 ________________
  712.  
  713.  
  714.      ACS  stands for Access Condition String, and is a powerful new  method
  715.      of  stating  the requirements and conditions under which  a  user  has
  716.      access to something -- whether it be a file area, a menu command, or a
  717.      text file in the text file section.
  718.  
  719.      The ACS system combines security levels (SL and DSL), AR and AC  flags
  720.      and several other unique features into a string of twenty  characters.
  721.      It  is ALMOST like a miniature programming language.  (I know some  of
  722.      you probably flinched at the word "programming"!)
  723.  
  724.      There  are 12 different functions in the ACS system, and all  of  them
  725.      have the same basic syntax:  A letter followed by the parameter of the
  726.      function,  all of which can be specified in upper or lower case.   The
  727.      following is a list of all possible functions.
  728.  
  729.           Function   :   "Annn"
  730.           Description:   Age of user
  731.           Access req.:   Must be as old as "nnn".
  732.  
  733.           Function   :   "Bnnn"
  734.           Description:   Baud rate, without last two zeros ("00")
  735.           Access req.:   Must be connected at "nnn" baud.
  736.  
  737.           Function   :   "Dnnn"
  738.           Description:   DSL
  739.           Access req.:   Must have DSL of "nnn" or higher.
  740.  
  741.           Function   :   "Fx"
  742.           Description:   AR flag
  743.           Access req.:   Must have AR flag "x" (A to Z).
  744.  
  745.           Function   :   "Gx"
  746.           Description:   Gender
  747.           Access req.:   Must have gender "x" (M or F).
  748.  
  749.           Function   :   "Pnnnnn"
  750.           Description:   File points
  751.           Access req.:   Must have AT LEAST "nnnnn" file points.
  752.  
  753.           Function   :   "Rx"
  754.           Description:   AC flag
  755.           Access req.:   Must have AC flag "x" (LCVBA*PEKM1234).
  756.  
  757.           Function   :   "Snnn"
  758.           Description:   SL level
  759.           Access req.:   Must have SL of "nnn" or higher.
  760.  
  761.           Function   :   "Tnnnnn"
  762.           Description:   Time left
  763.           Access req.:   Must have AT LEAST "nnnnn" minutes of time left.
  764.  
  765.  
  766.                                    - Page 10 -
  767.  
  768.                    PegaSys Main Documentation - Version 0.43
  769.  
  770.  
  771.           Function   :   "Unnnn"
  772.           Description:   User number
  773.           Access req.:   Must be user number "nnnn".
  774.  
  775.           Function   :   "VV"
  776.           Description:   Validation
  777.           Access req.:   Must be a validated user.
  778.  
  779.           Function   :   "Ynnnn"
  780.           Description:   Time of day
  781.           Access req.:   Must be AT LEAST "nnnn" minutes after midnight.
  782.  
  783.      The following are a few examples:
  784.  
  785.           "A21"  - Must be 21 years old to have access.
  786.           "B96"  - Must be connected at 9600 or higher baud rate.
  787.           "FS"   - Must have AR flag "S".
  788.           "T20"  - Must have at least 20 minutes time left.
  789.           "Y360" - Must be later than 6:00 am.
  790.  
  791.      There  are five logical operators that can be used in ACS, only  three
  792.      of which (the first three) are used frequently:
  793.  
  794.           "&" - Logical AND
  795.           "|" - Logical OR
  796.           "!" - Logical NOT
  797.           "^" - Logical TRUE
  798.           "%" - Logical FALSE
  799.  
  800.      The  default  operator  between  any  two  functions  is  AND.   Thus,
  801.      functions  can  be strung together without any operators  in  between.
  802.      For  example,  "S20D50"  (aka "S20&D50") requires SL 20  and  DSL  50.
  803.      "A21FSD255" (aka "A21&FS&D255") requires that the user be 21 or older,
  804.      AR flag "S", and DSL 255.
  805.  
  806.      The OR operator is simple to use.  For example, "S20|FA" requires that
  807.      the user have either SL 20 *OR* AR flag "A".  In either case, the user
  808.      meets the access requirement.
  809.  
  810.      The  NOT  operator is also easy to use.  Just place  a  "!"  character
  811.      before any function to reverse it's meaning.  For example: "!FA" means
  812.      the  user  must NOT have AR flag "A" to have access.   IMPORTANT:   Be
  813.      sure  to  remember  that,  in  numeric  functions,  the  NOT  operator
  814.      COMPLETELY  REVERSES THE MEANING of the function.  Thus,  "!S30"  does
  815.      NOT  mean "SL less than or equal to 30"; it means "SL less  than  30",
  816.      *without* the "equal to".
  817.  
  818.      The  TRUE and FALSE operators are used to give everyone access, or  to
  819.      not  give  anyone access.  "^" means all users have  access,  and  "%"
  820.      means  no users at all have access.  They are NOT meant to be used  in
  821.      combination with other ACS operators!
  822.  
  823.      To  provide  for  even more complex ACS's,  parentheses  are  allowed.
  824.      "(S20FA)|(D255)" means, for example, that the user must have SL 20 and
  825.      AR flag "A", *OR* DSL 255, to have access.
  826.  
  827.  
  828.  
  829.                                    - Page 11 -
  830.  
  831.                    PegaSys Main Documentation - Version 0.43
  832.  
  833.  
  834.      Here are some more examples:
  835.  
  836.           S50            User must have SL 50 to 255.
  837.           !S50           User must have SL 0 to 49.
  838.           VV|U1          User must be validated, or be user #1, to have
  839.                          access.
  840.           A21FAS50       User must be 21 years old, have AR flag "A", and
  841.                          and have 50 SL.
  842.           !(A21FAS50)    User has access so long as they do NOT have all of
  843.                          the following:  21 years old, AR flag "A", and
  844.                          SL 50.
  845.           !A21!FA!S50    User has access SO LONG AS they have NONE of the
  846.                          three.
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.                                    - Page 12 -
  893.  
  894.                    PegaSys Main Documentation - Version 0.43
  895.  
  896.  
  897.                              _____________________
  898.  
  899.                               THE MCI CODE SYSTEM
  900.                              _____________________
  901.  
  902.  
  903.      PegaSys  provides a powerful system for displaying and handling system
  904.      and  user  information, in prompts, command lines and  text  messages.
  905.      This  is  done  using  a set of  codes  called  MCI  (Message  Command
  906.      Interpreter).  These codes are entered with the character "@" followed
  907.      by  a specific ASCII character.  Changing colors in text  messages  is
  908.      accomplished through a special system that is described later.
  909.  
  910.  
  911.      ---------------------
  912.      MCI CODES FOR PROMPTS
  913.      ---------------------
  914.  
  915.      The following MCI codes may be used in the various prompt strings that
  916.      can  be configured through the system configuration.  These codes  may
  917.      also  be used in the "To:" and "Subject:" fields in  public  messages,
  918.      but  a  user may only see the results of these codes if  the  MCI  ACS
  919.      field for the particular message base allows it.
  920.  
  921.      Unless stated otherwise, information displayed by these MCI codes  are
  922.      displayed using the current MCI color.
  923.  
  924.           @A        Displays the current message board number in the format
  925.                     "#xxx".
  926.  
  927.           @B        Displays the current message board name.  If the name
  928.                     contains MCI color codes, it will be displayed using
  929.                     those colors; otherwise, it is displayed in MCI color
  930.                     #5 (default: yellow) if Local, or MCI color #0
  931.                     (default: bold white) if EchoMail or GroupMail.
  932.  
  933.           @C        Displays the current file board number in the format
  934.                     "#xxx".
  935.  
  936.           @D        Displays the current file board name.  If the name
  937.                     contains MCI color codes, it will be displayed using
  938.                     those colors; otherwise, it is displayed in MCI color
  939.                     #5 (default: yellow).
  940.  
  941.           @F        Displays the current user's real first name.
  942.  
  943.           @G        Sounds a beep (on the user's side only).
  944.  
  945.           @H        Displays the current user's user name minus the user
  946.                     number.
  947.  
  948.           @K        Displays the number of kilobytes (K) available on the
  949.                     drive of the current file board's upload path.
  950.  
  951.           @L        Displays the current user's real last name.
  952.  
  953.  
  954.  
  955.                                    - Page 13 -
  956.  
  957.                    PegaSys Main Documentation - Version 0.43
  958.  
  959.  
  960.           @M        Displays a carriage return/linefeed.
  961.  
  962.           @N        Displays the current user's user name and number.
  963.  
  964.           @P        Displays the number of file points remaining to the
  965.                     current user.
  966.  
  967.           @R        Displays the current user's entire real name.
  968.  
  969.           @T        Displays the amount of time online remaining to the
  970.                     current user in the format "HH:MM:SS".
  971.  
  972.           @U        Displays the message number that the current user is
  973.                     reading.
  974.  
  975.           @V        Displays the commands that are accessible to the
  976.                     current user at the current menu.
  977.  
  978.           @W        Displays the number of messages in the current message
  979.                     board.
  980.  
  981.           @X        Displays the maximum number of lines allowed for a
  982.                     message in the current message board.
  983.  
  984.           @Y        Displays the current message board name and number.  If
  985.                     the name contains MCI color codes, it will be displayed
  986.                     using those colors; otherwise, it is displayed in MCI
  987.                     color #5 (default: yellow) if Local, or MCI color #0
  988.                     (default: bold white) if EchoMail or GroupMail.  The
  989.                     number is ALWAYS displayed with MCI color #5 or #0.
  990.  
  991.           @Z        Displays the string entered when the current user
  992.                     requested a chat with the SysOp (the "chat reason").
  993.  
  994.  
  995.      ---------------------------
  996.      MCI CODES FOR DOOR COMMANDS
  997.      ---------------------------
  998.  
  999.      The  following MCI codes may be used for the command lines  passed  to
  1000.      DOS  when executing an external program (a "door").  Note that  though
  1001.      many of these codes duplicate information returned from the MCI prompt
  1002.      codes, these codes can ONLY be used with door command lines.  Any  MCI
  1003.      color codes that may be present are removed before the information  is
  1004.      passed.
  1005.  
  1006.           @N        Returns the current user's user name.
  1007.  
  1008.           @F        Returns the current user's first name.
  1009.  
  1010.           @L        Returns the current user's last name.
  1011.  
  1012.           @T        Returns the amount of time online remaining to the
  1013.                     current user (in minutes).
  1014.  
  1015.  
  1016.  
  1017.  
  1018.                                    - Page 14 -
  1019.  
  1020.                    PegaSys Main Documentation - Version 0.43
  1021.  
  1022.  
  1023.           @G        Returns a "1" if the current user has ANSI graphics
  1024.                     enabled, "0" if disabled.
  1025.  
  1026.           @R        Returns the current user's user number.
  1027.  
  1028.           @B        Returns the baud rate that the current user logged on
  1029.                     with.  Local keyboard logons are indicated with a "0"
  1030.                     (meaning no baud rate).
  1031.  
  1032.           @D        Returns the current file base's download directory
  1033.                     pathname.
  1034.  
  1035.           @I        Returns the current file base's *.DIR filename and
  1036.                     pathname.
  1037.  
  1038.  
  1039.      -------------------------------------
  1040.      MCI CODES FOR MESSAGES AND TEXT FILES
  1041.      -------------------------------------
  1042.  
  1043.      The  following  MCI codes may be used in .MSG text  files  and  public
  1044.      messages.   Note that if the current user's setup does not  match  the
  1045.      requirements for the MCI ACS field for a particular message base, that
  1046.      user cannot use these codes; they will instead be shown as "@1", "@2",
  1047.      etc.   (This does not apply to text files.)  The rules  regarding  MCI
  1048.      colors for MCI prompt codes also apply here.
  1049.  
  1050.           @1        Displays the current user's user name.
  1051.  
  1052.           @2        Displays the current user's real name.
  1053.  
  1054.           @3        Displays the current user's phone number.
  1055.  
  1056.           @4        Displays the current user's city & state.
  1057.  
  1058.           @5        Displays the current user's street address.
  1059.  
  1060.           @6        Displays the current user's postal zip code.
  1061.  
  1062.           @7        Clears the screen.
  1063.  
  1064.           @8        Provides a few seconds' delay.
  1065.  
  1066.           @9        Displays the "pause" string (defined in System
  1067.                     Configuration) and waits for the current user to press
  1068.                     a key.
  1069.  
  1070.           @!        Toggles the current user's ability to abort the message
  1071.                     or text file to OFF until it is finished being
  1072.                     displayed.
  1073.  
  1074.           @#        Toggles the "pause when screen is full" feature to OFF
  1075.                     (if enabled for the current user) until the message or
  1076.                     text file is finished being displayed.
  1077.  
  1078.  
  1079.  
  1080.  
  1081.                                    - Page 15 -
  1082.  
  1083.                    PegaSys Main Documentation - Version 0.43
  1084.  
  1085.  
  1086.      ---------------
  1087.      MCI COLOR CODES
  1088.      ---------------
  1089.  
  1090.      The  ability  to display any of the ten MCI colors in  messages,  text
  1091.      files,  prompt strings, etc., is provided via two methods.  The  first
  1092.      method  is usable almost everywhere in PegaSys :  At the  point  where
  1093.      you wish to change to another MCI color, press [Ctrl-P] (hold down the
  1094.      [Ctrl] key and press the "P" key, then release both) and then press  a
  1095.      number  key  ("0" through "9").  From then on, the current  MCI  color
  1096.      will  be  the one corresponding to the number you pressed,  until  the
  1097.      color  is changed again either by the system or by another  MCI  color
  1098.      code  sequence.
  1099.  
  1100.      (Technical  note:   The color code is stored as a  two-byte  sequence,
  1101.      "03" hexadecimal followed by "00" through "09" hexadecimal,  depending
  1102.      on  the  number  you selected.  This is why you  sometimes  see  funny
  1103.      characters  when  you TYPE a PegaSys  .MSG file from  DOS;  more  than
  1104.      likely, that file contains MCI color codes.)
  1105.  
  1106.      The  second method is to enter, at the point where you wish to  change
  1107.      colors,  a "^" character followed by a number character  ("0"  through
  1108.      "9").  For example, if you wished to change to MCI color #3, you would
  1109.      enter "^3".  This method is usable only in a few areas, which  include
  1110.      the system configuration string configuration section and the  prompts
  1111.      and strings in the menu editor's menu configuration section.
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.                                    - Page 16 -
  1145.  
  1146.                    PegaSys Main Documentation - Version 0.43
  1147.  
  1148.  
  1149.                              ______________________
  1150.  
  1151.                               SYSTEM CONFIGURATION
  1152.                              ______________________
  1153.  
  1154.  
  1155.      At  the heart of PegaSys  is the system configuration feature.  It  is
  1156.      here  that  the entire operation of the system is set up,  from  modem
  1157.      configuration to file archiving options to time allowances and  upload
  1158.      and  download  restrictions.   This section is  selected  by  the  "P"
  1159.      command  at both the Wait For Caller (WFC) screen and the  SysOp  Menu
  1160.      (while executing the BBS).
  1161.  
  1162.      Once selected, the following menu is displayed:
  1163.      ______________________________________________________________________
  1164.  
  1165.      System configuration:
  1166.  
  1167.      A. Modem Configuration
  1168.      B. File paths & BBS configuration
  1169.      C. System ACS settings
  1170.      D. General variables
  1171.      E. General flagged functions
  1172.      F. File section configuration
  1173.      G. New user and Auto-Validation settings
  1174.      H. Miscellaneous configuration
  1175.      I. FidoNet configuration
  1176.      S. String configuration
  1177.      Z. Default Colors
  1178.  
  1179.      1. Time limitations
  1180.      2. Call allowance/day
  1181.      3. UL/DL # files ratio
  1182.      4. UL/DL K-bytes ratio
  1183.      5. Post/Call ratio
  1184.  
  1185.      Enter selection (A-I,SZ,1-5) [Q]uit :
  1186.      ______________________________________________________________________
  1187.  
  1188.      Selecting one of the keys will take you to the appropriate section  of
  1189.      the system configuration.  Pressing "Q" will take you back to the  WFC
  1190.      screen (or the SysOp Menu).
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.                                    - Page 17 -
  1208.  
  1209.                    PegaSys Main Documentation - Version 0.43
  1210.  
  1211.  
  1212.      -------------------
  1213.      MODEM CONFIGURATION
  1214.      -------------------
  1215.  
  1216.      Modem  Configuration allows you to set up how the modem  and  PegaSys
  1217.      communicate.  It is here that the COM port, modem commands and  result
  1218.      codes are configured.
  1219.  
  1220.      Note   that  the  default  settings  that  are  installed   with   the
  1221.      initialization  package are suitable for most standard modems (300  to
  1222.      2400  baud).   However,  as is the case with  most  things  concerning
  1223.      computers,  one configuration will simply not do for every  situation.
  1224.      This  is  especially true concerning modems.  That is why there  is  a
  1225.      special  section for modem information (called, appropriately  enough,
  1226.      "Modem  Information").  This section includes alternate  configuration
  1227.      strings,  information for setting up PegaSys  with various  9600  baud
  1228.      modems, and how to use PegaSys  with a FOSSIL communications driver.
  1229.  
  1230.      By  default, PegaSys  is set up for use with a Hayes compatible  modem
  1231.      (whatever that means nowadays).  If you modem does not fall into  this
  1232.      category -- older modems from Radio Shack, for instance, use their own
  1233.      command  sets -- you will have to make modifications to the  settings.
  1234.      Consult the manual for your modem for the correct information.
  1235.  
  1236.      Upon selecting this option, the following menu is displayed:
  1237.      ______________________________________________________________________
  1238.  
  1239.      Modem configuration
  1240.  
  1241.      1. Maximum baud rate    : 1200
  1242.      2. COM port number      : 1
  1243.      3. Modem initialization string:
  1244.         "ATH0Q0V0E0M0X1S0=0S2=1S10=40&C1"
  1245.      4. Modem answer string  : "ATA"
  1246.      5. Modem hangup string  : "~~~^A^A^A~~~ATH0"
  1247.      6. Modem offhook string : "ATH1M0"
  1248.      7. No call init. time   : 30
  1249.      A. 9600 ARQ rate baud   : 9600 baud
  1250.      F. Forced baud rates?   : Yes
  1251.      R. Modem result codes:
  1252.                           Case 1    Case 2 (ARQ)
  1253.         R1. NO CARRIER :  3
  1254.         R2. NO DIALTONE:  6
  1255.         R3. BUSY       :  7
  1256.         R4.  300 BAUD  :  1         0
  1257.         R5. 1200 BAUD  :  5         15
  1258.         R6. 2400 BAUD  :  10        16
  1259.         R7. 4800 BAUD  :  0         0
  1260.         R8. 9600 BAUD  :  13        17
  1261.  
  1262.      Enter selection or (Q)uit :
  1263.      ______________________________________________________________________
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.                                    - Page 18 -
  1271.  
  1272.                    PegaSys Main Documentation - Version 0.43
  1273.  
  1274.  
  1275.      Note  that  the  command strings can  contain  the  following  special
  1276.      characters:
  1277.  
  1278.           "|"       Sends a carriage return to the modem.  Note that all
  1279.                     strings are automatically terminated with a carriage
  1280.                     return, so this character is not needed at the end of
  1281.                     the strings.
  1282.  
  1283.           "^x"      Sends a control character to the modem.  The "x" is an
  1284.                     uppercase letter (A-Z), and will correspond to control
  1285.                     codes 1 through 26.
  1286.  
  1287.           "~"       Performs a half-second delay before sending the next
  1288.                     character to the modem.
  1289.  
  1290.      Each menu option is described in detail below.
  1291.  
  1292.           1    This is the baud rate that PegaSys  will use when waiting
  1293.                for calls at the WFC menu.  This should be set to the
  1294.                modem's maximum baud rate, at either 300, 1200, 2400, 4800,
  1295.                9600, 19200 or 38400 baud.
  1296.  
  1297.           2    This is the COM port that your modem is connected to, which
  1298.                can be COM1 through COM4.
  1299.  
  1300.           3    This is the command that initializes the modem.  This is
  1301.                VERY important, as it tells the modem how to operate under
  1302.                the BBS environment.  If your modem does not respond using
  1303.                the default command, consult the "Modem Information" section
  1304.                for more information (or "play" with the command until you
  1305.                get it just right).
  1306.  
  1307.           4    This is the command that enables the modem to answer an
  1308.                incoming call.
  1309.  
  1310.           5    This is the command that hangs up the modem.
  1311.  
  1312.           6    This is the command that places the modem offhook (when you
  1313.                wish to have SOME access to your computer!).  This has the
  1314.                same effect as taking the receiver off the hook on your
  1315.                telephone.
  1316.  
  1317.           7    This sets the time (in minutes) in which the modem will be
  1318.                reinitialized if no one has called.  Do NOT set this option
  1319.                to zero (0); if you do, the modem will be constantly
  1320.                reinitialized, and will not let anyone call in (nor will it
  1321.                let you regain control of the system until you press the
  1322.                Reset button!).
  1323.  
  1324.           A    This sets the ARQ baud rate used with 9600 baud (or higher)
  1325.                modems.  Consult your modem's manual for more details on the
  1326.                ARQ feature.
  1327.  
  1328.           F    This option sets the forced baud rate used with 9600 baud
  1329.                (or higher) modems.
  1330.  
  1331.  
  1332.  
  1333.                                    - Page 19 -
  1334.  
  1335.                    PegaSys Main Documentation - Version 0.43
  1336.  
  1337.  
  1338.           R    These are the result codes returned by the modem when the NO
  1339.                CARRIER, NO DIALTONE, BUSY and various baud rate conditions
  1340.                are encountered.  Case 1 result codes are the main codes
  1341.                returned by the modem.  Case 2 result codes are provided for
  1342.                persons using MNP class modems (such as the USR Courier
  1343.                HST), which are designed to filter more noise and give a
  1344.                better grade connection, in the ARQ mode.
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.                                    - Page 20 -
  1397.  
  1398.                    PegaSys Main Documentation - Version 0.43
  1399.  
  1400.  
  1401.      ------------------------------
  1402.      FILE PATHS & BBS CONFIGURATION
  1403.      ------------------------------
  1404.  
  1405.      This area is where many of the various BBS options are configured,  as
  1406.      well  as  the required file paths that the program needs to  find  its
  1407.      files.
  1408.  
  1409.      Upon selecting this option, the following menu is displayed (the  menu
  1410.      has been slightly compressed to fit onto the page):
  1411.      ______________________________________________________________________
  1412.  
  1413.      BBS configuration and file paths
  1414.  
  1415.      A. BBS name & number  :PegaSys  BBS (000-000-0000)
  1416.      B. SysOp's name/alias :<System Operator>
  1417.      C. SysOp chat hours   :*None*          G. 300 baud hours    :Always...
  1418.      D. Regular DL hours   :Always allowed  H. 300 baud DL hours :Always...
  1419.      E. Shuttle Logon is   :In-active       I. New users are     :Accepted
  1420.      !. LOCKOUT 300 BAUD   :No              J. Snow checking is  :In-active
  1421.      F. BBS Passwords                       K. Pre-event warning :60
  1422.  
  1423.       1. Main data files dir.    :"C:\BBS\GFILES\"
  1424.       2. Alternate text file dir.:"C:\BBS\AFILES\"
  1425.       3. Priv/pub msgs directory :"C:\BBS\MSGS\"
  1426.       4. Menu file directory     :"C:\BBS\MENUS\"
  1427.       5. Text-file section dir.  :"C:\BBS\TFILES\"
  1428.       6. Trap/log/chat directory :"C:\BBS\TRAP\"
  1429.       7. Temporary directory     :"C:\BBS\TEMP\"
  1430.       8. Last text-file edit date:04/21/89
  1431.  
  1432.      Enter selection (A-K,!,1-8) [Q]uit :
  1433.      ______________________________________________________________________
  1434.  
  1435.      Each option is described in detail below.
  1436.  
  1437.           A    This option allows you to enter the name and the phone
  1438.                number of your BBS, which is used as a general string during
  1439.                the logon procedure.  MCI color codes are allowed.
  1440.  
  1441.           B    This option allows you to enter the name or the handle of
  1442.                the SysOp (you!), which is used in various places throughout
  1443.                the program.
  1444.  
  1445.           C    This option allows you to declare your chat hours.  When
  1446.                someone pages you during these hours, a bell will sound to
  1447.                inform you that a user wishes to chat.  Also, during the
  1448.                logon procedure, a message is displayed that indicates the
  1449.                status of the SysOp.  If a user logs on within the chat
  1450.                hours, the SysOp is declared "available to chat", otherwise
  1451.                the SysOp is declared "unavailable to chat".
  1452.  
  1453.                Alternately, you may leave the chat hours as "undefined."
  1454.                This allows the use of a special feature associated with the
  1455.                [Scroll Lock] key.  When [Scroll Lock] is active, the BBS
  1456.                declares that the SysOp is unavailable; when inactive, the
  1457.  
  1458.  
  1459.                                    - Page 21 -
  1460.  
  1461.                    PegaSys Main Documentation - Version 0.43
  1462.  
  1463.  
  1464.                BBS declares that the SysOp is available.  This allows you
  1465.                to control the chat status via the keyboard.
  1466.  
  1467.           D    This option defines the hours that file downloading is
  1468.                allowed.  Some SysOps prefer to have certain hours set aside
  1469.                for non-file related activities (posting messages, etc.);
  1470.                this option allows that.  The default is to always allow
  1471.                file downloading.
  1472.  
  1473.           E    This option toggles the status of the shuttle logon.  The
  1474.                shuttle logon provides an extra layer of security for the
  1475.                BBS, which is desired by some SysOps.
  1476.  
  1477.           !    This option allows you to lock out 300 baud users.  Some
  1478.                SysOps do not wish to tie up their systems with users that
  1479.                use slow (and outdated) 300 baud modems.  The default is NO.
  1480.                If this feature is activated, and a 300 baud user tries to
  1481.                log on, the message NO300.* is displayed during the logon
  1482.                procedure and the BBS will hang up.
  1483.  
  1484.           F    This option defines the SysOp, new user and shuttle logon
  1485.                passwords.
  1486.  
  1487.           G    This option defines the hours that 300 baud callers may log
  1488.                on.  Some SysOps prefer to restrict the hours available to
  1489.                users of 300 baud modems.  The default is to always allow
  1490.                300 baud callers.  If these hours are defined, and a 300
  1491.                baud caller tries to log on, the file 300HOURS.* is
  1492.                displayed during the logon procedure and the BBS will hang
  1493.                up.
  1494.  
  1495.                Note that this option is pretty much useless if 300 baud
  1496.                users are locked out (the "!" option).
  1497.  
  1498.           H    This option defines the hours that 300 baud callers may
  1499.                download files.  Again, some SysOps prefer to restrict the
  1500.                activities of user with 300 baud modems (due to their
  1501.                slowness).  The default is to always allow 300 baud callers
  1502.                to download files.
  1503.  
  1504.                Once again, note that this option is useless if 300 baud
  1505.                users have been locked out (with the "!" option).
  1506.  
  1507.           I    This option allows you to accept or lock out new users.  The
  1508.                default is to always accept new users.  If you decide you
  1509.                have enough users, or you wish to run a private board where
  1510.                only certain people are permitted access, you should set
  1511.                this option to lock out new users.
  1512.  
  1513.           J    This option toggles video snow checking.  This option is
  1514.                mainly for systems using a Color Graphics Adapter (CGA),
  1515.                which is susceptible to video "snow" during direct writes to
  1516.                the screen.  (Systems with monochrome adapters, Enhanced
  1517.                Graphics Adapters [EGA] or Video Graphics Array [VGA]
  1518.                adapters usually do not have this problem.)  The default is
  1519.                no snow checking.
  1520.  
  1521.  
  1522.                                    - Page 22 -
  1523.  
  1524.                    PegaSys Main Documentation - Version 0.43
  1525.  
  1526.  
  1527.           K    This options sets the number of seconds before a scheduled
  1528.                event is run in which the user is warned.  This gives the
  1529.                user time to finish up and log off.  The default is 60
  1530.                seconds (one minute).
  1531.  
  1532.           1    This option defines the directory in which your main data
  1533.                files are stored.  These include the file directory (*.DIR)
  1534.                and miscellaneous system (*.DAT, *.LST) files.
  1535.  
  1536.           2    This option defines the directory in which your text files
  1537.                are stored.  These files include ANSI (*.ANS), text (*.MSG),
  1538.                and InfoForm question (*.INF) and answer (*.ASW) files.
  1539.  
  1540.           3    This option defines the directory in which your public
  1541.                and private message files (*.BRD, *.MIX, *.TRE) are stored.
  1542.  
  1543.           4    This option defines the directory in which the menu files
  1544.                (*.MNU) are stored.
  1545.  
  1546.           5    This option defines the directory in which the text file
  1547.                system (Tfiles) files are stored.  These files may be viewed
  1548.                by various users, and their contents can cover a wide range
  1549.                of interests and topics.  (See the section on Tfiles for
  1550.                more information on this feature.)
  1551.  
  1552.           6    This option defines the directory in which the trap files
  1553.                (TRAP*.MSG), system log files (SYSOP*.LOG) and capture chat
  1554.                files (CHAT*.MSG) are stored.
  1555.  
  1556.           7    This option defines the directory in which temporary files
  1557.                are stored.  During the course of BBS operation, this
  1558.                directory is used for:  Holding incoming batch uploads until
  1559.                the queue is empty; converting archive files between
  1560.                different formats (ARC, LZH, PAK, ZIP, ZOO, or other user-
  1561.                defined formats); holding files processed using the
  1562.                "(E)xtract to Temp" and "(W)ork on Temp" commands from the
  1563.                File Transfer menu (more on this later); and so on.  It is
  1564.                recommended that this path point to a drive that has plenty
  1565.                of space available (at least 1MB is recommended).
  1566.  
  1567.           8    This option defines the date in which your text files
  1568.                (Tfiles) were last edited and/or updated.
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.                                    - Page 23 -
  1586.  
  1587.                    PegaSys Main Documentation - Version 0.43
  1588.  
  1589.  
  1590.      -------------------
  1591.      SYSTEM ACS SETTINGS
  1592.      -------------------
  1593.  
  1594.      These  settings define how many of the features of the BBS will  oper-
  1595.      ate, from posting features to file transfer ratio/file point  checking
  1596.      to Co-SysOp and SysOp access levels.  Each setting is set up using the
  1597.      Access  Condition String (ACS) system (refer to the "The  ACS  System"
  1598.      section for more information).
  1599.  
  1600.      Upon selecting this option, the following menu is displayed (the  menu
  1601.      has been slightly compressed to fit on the page):
  1602.      ______________________________________________________________________
  1603.  
  1604.      System ACS settings:
  1605.  
  1606.      A. Full SysOp              :"s255"  B. Full Co-SysOp           :"s250"
  1607.      C. Message base SySop      :"s199"  D. File base SysOp         :"s230"
  1608.      E. SysOp Password at logon :"s250"  F. See passwords remotely  :"s255"
  1609.      G. Post normal public mail :"s11"   H. Send normal private mail:"s11"
  1610.      I. See who posted anon     :"s100"  J. See who Emailed anon    :"s100"
  1611.      K. Post on ANY base anon   :"s100"  L. Email anon              :"s100"
  1612.      M. See unvalidated files   :"s50"   N. DL unvalidated files    :"s230"
  1613.      O. No UL/DL ratio checking :"s255"  P. No post/call ratio check:"s200"
  1614.      R. No file point checking  :"s255"  S. ULs auto-credited       :"s21"
  1615.  
  1616.      Enter selection (A-S) [Q]uit :
  1617.      ______________________________________________________________________
  1618.  
  1619.      Each option is described in detail below.
  1620.  
  1621.           A    This setting defines the security level for a full SysOp.
  1622.  
  1623.           B    This setting defines the security level for a full Co-SysOp.
  1624.  
  1625.           C    This setting defines the security level for a message base
  1626.                SysOp.
  1627.  
  1628.           D    This setting defines the security level for a file base
  1629.                SysOp.
  1630.  
  1631.           E    This setting defines the security level in which the SysOp
  1632.                password must be specified during the logon process.
  1633.  
  1634.           F    This setting defines the security level in which a user can
  1635.                view passwords remotely.
  1636.  
  1637.           G    This setting defines the security level required to post
  1638.                normal public mail.
  1639.  
  1640.           H    This setting is similar to option G, except that it pertains
  1641.                to normal Email.
  1642.  
  1643.           I    This setting defines the security level that allows a user
  1644.                to see who posted public messages anonymously.
  1645.  
  1646.  
  1647.  
  1648.                                    - Page 24 -
  1649.  
  1650.                    PegaSys Main Documentation - Version 0.43
  1651.  
  1652.  
  1653.           J    This setting defines the security level that allows a user
  1654.                to see who posted Email anonymously.
  1655.  
  1656.           K    This setting defines the security level that allows a user
  1657.                to post anonymously on ANY message base, regardless of the
  1658.                settings of the anonymous flags for the message bases.
  1659.  
  1660.           L    This setting is similar to option K, except that it pertains
  1661.                to Email.
  1662.  
  1663.           M    This setting defines the security level that allows a user
  1664.                to see unvalidated files when listing the files in the file
  1665.                bases.
  1666.  
  1667.           N    This setting defines the security level that allows a user
  1668.                to download unvalidated files.
  1669.  
  1670.           O    This setting defines the security level at which upload/
  1671.                download ratio checking is suppressed.
  1672.  
  1673.           P    This setting defines the security level at which the post/
  1674.                call ratio check is suppressed.
  1675.  
  1676.           R    This setting defines the security level at which file point
  1677.                checking is suppressed.
  1678.  
  1679.           S    This setting defines the security level at which uploaded
  1680.                files are automatically credited to the uploader.  (Setting
  1681.                the security level to a value higher than that for normal
  1682.                users will prevent uploading of "garbage" in order to
  1683.                balance an UL/DL ratio for further downloading, thereby
  1684.                preventing "leeching" of the file sections.)
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.                                    - Page 25 -
  1712.  
  1713.                    PegaSys Main Documentation - Version 0.43
  1714.  
  1715.  
  1716.      -----------------
  1717.      GENERAL VARIABLES
  1718.      -----------------
  1719.  
  1720.      This  section controls various numeric values and limits for the  BBS,
  1721.      such  as  the  maximum number of lines per message,  number  of  logon
  1722.      attempts,  and  the  number of minutes of inactivity  before  the  WFC
  1723.      screen is blanked.
  1724.  
  1725.      Upon selecting this option, the following menu is displayed:
  1726.      ______________________________________________________________________
  1727.  
  1728.      General variables:
  1729.  
  1730.      A. Max private sent per call:20      B. Max feedback sent per call:5
  1731.      C. Max public posts per call:20      D. Max chat attempts per call:3
  1732.      E. Normal max mail waiting  :15      F. CoSysOp max mail waiting  :50
  1733.      G. Normal max lines/message :120     H. CoSysOp max lines/message :160
  1734.      I. Number of logon attempts :4       J. Backspace delay           :20
  1735.      K. SysOp chat color         :4       L. User chat color           :3
  1736.      M. Min space for posts      :10      N. Min space for uploads     :100
  1737.      O. Back SysOp Log keep days :7       P. Blank WFC menu minutes    :0
  1738.      R. Default video page width :80      S. Default video page length :25
  1739.  
  1740.      Enter selection (A-S) [Q]uit :
  1741.      ______________________________________________________________________
  1742.  
  1743.      Each option is described in detail below.
  1744.  
  1745.           A    This option sets the limit for the amount of Email that
  1746.                any single caller can leave during a visit (as it can be
  1747.                distracting AND FRUSTRATING when some guy finds the need to
  1748.                mass mail every caller three times a week!).
  1749.  
  1750.           B    This option sets the limit for the number of feedback
  1751.                messages that any single caller can send during a visit.
  1752.                This option should usually be kept low, the reason being
  1753.                that feedback comes to YOU, the SysOp, and if you have 40
  1754.                callers a day, and every one leaves 20 messages to you, soon
  1755.                you no longer have any room on your hard drive!
  1756.  
  1757.           C    This option sets the limit for the number of public messages
  1758.                that any single caller can send during a visit.  This option
  1759.                is RARELY exceeded (unfortunately!).
  1760.  
  1761.           D    This option sets the limit for the number of chat attempts
  1762.                that any single caller can make during a visit.  Again, this
  1763.                number is usually kept rather low, as a SysOp has a life
  1764.                besides the BBS (usually!), and some callers constantly page
  1765.                for chat when he has other things that need to be done.
  1766.  
  1767.           E    This option sets the limit for the amount of Email that can
  1768.                be kept waiting for a given caller.  It keeps a limit so
  1769.                that people are ENCOURAGED to discard old Email to save disk
  1770.                space.
  1771.  
  1772.  
  1773.  
  1774.                                    - Page 26 -
  1775.  
  1776.                    PegaSys Main Documentation - Version 0.43
  1777.  
  1778.  
  1779.           F    This option sets the limit for the amount of Email that can
  1780.                be kept waiting for a Co-SysOp.  This number should be
  1781.                relatively high compared to that of an average user, as a
  1782.                remote has duties that may include file requests, system
  1783.                questions and new user validations.
  1784.  
  1785.           G    This option sets the limit for the number of lines allowed
  1786.                in any given message for a normal user.
  1787.  
  1788.           H    This option sets the limit for the number of lines allowed
  1789.                in any given message for the Co-SysOp.  Again, a Co-SysOp
  1790.                deserves more as, though most questions are short, some may
  1791.                go into VERY lengthy explanations and replies.
  1792.  
  1793.           I    This option sets the limit for the number of attempts a user
  1794.                can make to log on to the BBS, before the system automatic-
  1795.                ally hangs up on the caller.
  1796.  
  1797.           J    This option sets the delay value between the time the system
  1798.                erases the "Saving message..." string and prints the
  1799.                "Message posted on..." string when posting a message.
  1800.                Setting this option to zero (0) eliminates the delay
  1801.                completely.
  1802.  
  1803.           K    This option sets the SysOp chat color, which can be 0 to 9
  1804.                (corresponding to the PegaSys  MCI colors, explained later).
  1805.                For those users that can view ANSI colors, this color is
  1806.                used while the SysOp is typing.  Note that if a SysOp chat
  1807.                color filter is defined (more on this later), this setting
  1808.                is ignored.
  1809.  
  1810.           L    This is analogous to option K, except that it pertains to
  1811.                the user chat color.  (The reason for different chat colors
  1812.                for the SysOp and the user is primarily for visual ease and
  1813.                differentiation of the conversation.)  Same rules and
  1814.                restrictions apply.
  1815.  
  1816.           M    This option sets the minimum amount of hard drive space (in
  1817.                kilobytes, or K) that MUST be available in order to post a
  1818.                public message or Email.  It is designed as a safeguard, as
  1819.                problems can result if there is not enough space available
  1820.                (result can be a runtime error and/or a locked-up system).
  1821.  
  1822.           N    This is analogous to option M, except that it specifies the
  1823.                minimum amount of hard drive space (again, in kilobytes)
  1824.                that MUST be available to upload a file.  This is another
  1825.                safeguard so people can't fill up the drive.
  1826.  
  1827.           O    This option sets the number of days that the SysOp back logs
  1828.                are kept.  The maximum is 15, so that the SysOp has a
  1829.                running record of up to approximately two weeks to review
  1830.                BBS activity.
  1831.  
  1832.           P    This option sets the number of minutes of inactivity before
  1833.                the WFC screen is blanked.  This is provided as a safeguard
  1834.                against "burning in" the image of the WFC screen onto the
  1835.  
  1836.  
  1837.                                    - Page 27 -
  1838.  
  1839.                    PegaSys Main Documentation - Version 0.43
  1840.  
  1841.  
  1842.                phosphor of the CRT.  (Pressing the [Enter] key will
  1843.                redisplay the WFC screen.)  Setting this option to zero (0)
  1844.                will disable the blanking feature.
  1845.  
  1846.           R    This option defines the default number of video columns set
  1847.                for the user during the new user logon process.
  1848.  
  1849.           S    This option defines the default number of video rows set for
  1850.                the user during the new user logon process.
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.                                    - Page 28 -
  1901.  
  1902.                    PegaSys Main Documentation - Version 0.43
  1903.  
  1904.  
  1905.      -------------------------
  1906.      GENERAL FLAGGED FUNCTIONS
  1907.      -------------------------
  1908.  
  1909.      These options control various functions of the BBS, from clearing  the
  1910.      screen  before displaying messages to allowing handles to  controlling
  1911.      various actions during the logon procedure.
  1912.  
  1913.      Upon selection this option, the following menu is displayed:
  1914.      ______________________________________________________________________
  1915.  
  1916.      General flagged functions:
  1917.  
  1918.      A. Special effects          :On      B. Use FOSSIL comm driver    :Off
  1919.      C. Handles allowed on system:On      D. Phone number in logon     :On
  1920.      E. Local security protection:Off     F. Local screen security     :Off
  1921.      G. Global activity trapping :Off     H. Auto chat buffer open     :On
  1922.      I. AutoMessage in logon     :On      J. Bulletins in logon        :On
  1923.      K. Last few callers in logon:On      L. "Your Info" in logon      :On
  1924.      M. BBS is multi-tasking     :Off     N. Offhook in local logon    :On
  1925.      O. Mandatory voting         :Off     P. Compress file/msg numbers :Off
  1926.      R. UL duplicate file search :Off     S. SysOp Log type      :File Only
  1927.      T. Strip color off SysOp log:Off     U. Use WFC menu logo         :On
  1928.      V. Use BIOS for video output:On      W. Suppress snow on CGA      :Off
  1929.      X. Use EMS for overlay file :Off
  1930.  
  1931.      1. New user message sent to :1       2. Guest user number         :Off
  1932.      3. Mins before timeout bell :2       4. Mins before timeout       :5
  1933.  
  1934.      Enter selection (A-X,1-4) [Q]uit :
  1935.      ______________________________________________________________________
  1936.  
  1937.      Each option is described in detail below.
  1938.  
  1939.           A    This option controls the "special effects" feature of the
  1940.                WFC screen (the rotating colors in the "PEGASYS" logo).
  1941.  
  1942.           B    This option specifies whether or not to use a FOSSIL
  1943.                communications driver instead of the built-in communications
  1944.                routines.  (Refer to the "Modem Information" section for
  1945.                more details about FOSSIL drivers.)  If this option is
  1946.                enabled, and PegaSys  does not detect a FOSSIL driver, the
  1947.                built-in communications routines will be used.
  1948.  
  1949.           C    This option specifies whether or not handles are allowed on
  1950.                the system.  Having this option active enables users to be
  1951.                expressed by a pseudonym or alias (their real name is asked
  1952.                for during the new user logon process).  Disabling this
  1953.                option allows only the user's real name to be used
  1954.                (primarily for businesses and SysOps who wish callers to use
  1955.                their real names).
  1956.  
  1957.           D    This option specifies whether or not the user's phone number
  1958.                is asked for during the logon process.  This acts as an
  1959.                extra security feature just in case someone has illegally
  1960.                acquired someone else's password.
  1961.  
  1962.  
  1963.                                    - Page 29 -
  1964.  
  1965.                    PegaSys Main Documentation - Version 0.43
  1966.  
  1967.  
  1968.           E    This option controls local security protection.  When set
  1969.                to ON, it prevents the SysOp (and anyone else that may be
  1970.                present) from seeing the caller type his password and phone
  1971.                number (if active).  Good for "friends" that visit you and
  1972.                may try something stupid.
  1973.  
  1974.           F    This option controls local screen security.  When set to
  1975.                ON, the SysOp will see a "Baud = nnnnn" message in the upper
  1976.                left hand corner of the screen as usual.  However, that is
  1977.                ALL that will remain, in addition to the status line... in
  1978.                effect, you CANNOT see what is going on at ALL.
  1979.  
  1980.           G    This option controls global activity trapping.  If set to
  1981.                ON, the BBS will make a trap file for EVERY caller (in the
  1982.                form of TRAP*.MSG).  This is useful in the event of numerous
  1983.                system errors, runtime errors or BBS crashes, in order to
  1984.                find a solution to the problem.
  1985.  
  1986.           H    This option specifies whether or not to automatically open
  1987.                the chat buffer.  If set to ON, the chat is automatically
  1988.                recorded in the CHAT*.MSG file when the SysOp initiates
  1989.                chat, without having to press the [Home] key first.
  1990.  
  1991.           I    This option specifies whether or not the auto-message is
  1992.                displayed during the logon process.  Enables you to make the
  1993.                auto-message totally optional or mandatorily viewed by all
  1994.                callers.
  1995.  
  1996.           J    This option specifies whether or not the bulletin menu is
  1997.                presented during the logon process, enabling the SysOp to
  1998.                display dated bulletins that are of special interest to
  1999.                callers, such as BBS lists, online game scores, file request
  2000.                lists, and so on.
  2001.  
  2002.           K    This option specifies whether or not the last few callers
  2003.                are displayed during the logon process.  If set to ON, the
  2004.                last few callers will be displayed right after the
  2005.                automessage (if present).
  2006.  
  2007.           L    This option specifies whether or not the user's individual
  2008.                statistics are shown during the logon process.  This feature
  2009.                was left over from early versions of PegaSys , and has been
  2010.                made optional by request of various SysOps and users that
  2011.                did not appreciate it being automatically displayed.
  2012.  
  2013.           M    This option specifies whether or not the BBS is running
  2014.                under a multi-tasking environment.  (This feature has not
  2015.                yet been implemented.)
  2016.  
  2017.           N    This option specifies whether or not the phone should be
  2018.                taken off-hook during local logon, so that the SysOp can use
  2019.                the BBS without worrying about a user trying to log on.
  2020.  
  2021.           O    This option specifies whether or not to force all users to
  2022.                vote on all unanswered voting questions before they may
  2023.                enter the BBS.
  2024.  
  2025.  
  2026.                                    - Page 30 -
  2027.  
  2028.                    PegaSys Main Documentation - Version 0.43
  2029.  
  2030.  
  2031.           P    This option controls the "compression" of file and message
  2032.                base numbers.  This feature takes a little explaining, so an
  2033.                example is in order:
  2034.  
  2035.                Say that you have defined ten message bases (1-10), and that
  2036.                bases 5, 7 and 8 are restricted from certain users.  Now,
  2037.                normally, when the list of message areas is displayed, those
  2038.                areas will not be shown, leaving a gap in the message base
  2039.                numbers (1, 2, 3, 4, 6, 9, 10).  If this option is set to
  2040.                ON, all the message base numbers are made contiguous (1, 2,
  2041.                3, 4, 5, 6, 7) to the user.  THIS, HOWEVER, DOES NOT CHANGE
  2042.                THE PHYSICAL BASE NUMBERS!  This feature takes some getting
  2043.                used to, so you should experiment with it to make yourself
  2044.                more familiar with it.
  2045.  
  2046.           R    This option controls the search for duplicate files during
  2047.                the uploading process.  If set to ON, the BBS will search
  2048.                the file directories for the same file that the user is
  2049.                attempting to upload.  The BBS will also perform "partial"
  2050.                searches (if the same file is uploaded with a different
  2051.                extension, i.e. "FILE.ZIP" already exists and the user tries
  2052.                to upload "FILE.ARC").  In this case, if the preexisting
  2053.                file is in a base accessible to the user, the user will be
  2054.                asked if the upload is still wanted.  If the preexisting
  2055.                file is in a base that the user does NOT have access to, the
  2056.                upload will be rejected outright.
  2057.  
  2058.           S    This option controls the operation of the SysOp log.  When
  2059.                this option is selected, you can choose one of three types:
  2060.  
  2061.                     File only -- Saves the day's events in the SYSOPxx.LOG
  2062.                          file in the TRAP directory.
  2063.  
  2064.                     Printer & file -- Saves the data in the SYSOPxx.LOG
  2065.                          file and spools the output to the printer
  2066.                          throughout the day as activity continues.
  2067.  
  2068.                     Printer only -- Spools the information only to the
  2069.                          printer, providing a hardcopy record, but no file
  2070.                          record, of daily activity.
  2071.  
  2072.           T    This option specifies whether or not PegaSys 's MCI color
  2073.                codes will be stripped from the SysOp log.  If set to ON,
  2074.                the color codes are stripped (leaving pure ASCII text).
  2075.  
  2076.           U    This option specifies whether or not the "PEGASYS" logo is
  2077.                displayed at the WFC menu.  If set to OFF, a full-screen WFC
  2078.                screen can be created (it releases an extra six lines at
  2079.                the top of the screen for use).
  2080.  
  2081.           V    This option specifies whether or not ROM BIOS routines are
  2082.                to be used for all local screen output.  If disabled, screen
  2083.                output is written directly to video memory.  Enabling this
  2084.                option is useful on systems that aren't 100% compatible with
  2085.                the IBM PC standard (for instance, the Tandy 2000).
  2086.  
  2087.  
  2088.  
  2089.                                    - Page 31 -
  2090.  
  2091.                    PegaSys Main Documentation - Version 0.43
  2092.  
  2093.  
  2094.           W    This option specifies whether or not "snow checking" is
  2095.                required for Color Graphics Adapters (CGAs).  On most CGAs,
  2096.                interference will result if characters are stored in video
  2097.                memory outside the horizontal retrace intervals, resulting
  2098.                in "snow" (this does not occur with Monochrome Display
  2099.                Adapters [MDAs], Enhanced Graphics Adapters [EGAs], or Video
  2100.                Graphics Array adapters [VGAs]).  Enabling this option will
  2101.                make all screen writes occur only during the horizontal
  2102.                retrace intervals.  (This option has no effect if option V
  2103.                is enabled to select BIOS output.)
  2104.  
  2105.           X    This option specifies whether or not the BBS.OVR file is to
  2106.                be stored in, and accessed from, EMS (expanded) memory.  If
  2107.                the overlay can't be stored in EMS (no EMS present, not
  2108.                enough EMS RAM available, etc.), PegaSys  will access the
  2109.                overlay from disk as usual.  NOTE:  Any changes to this
  2110.                option require that PegaSys  be exited and restarted for
  2111.                the change to take effect.  Also, you will need enough EMS
  2112.                memory to hold the entire overlay file in order for this
  2113.                feature to work.
  2114.  
  2115.           1    This option defines the number of the user that will receive
  2116.                "new user" messages.  The default is user 1 (the SysOp), but
  2117.                can be changed if you have another user who handles the
  2118.                validation of new users.
  2119.  
  2120.           2    This option specifies whether or not a "guest user"
  2121.                account is to be used.  If toggled on, a generic account
  2122.                with low access is created called "GUEST", so that new
  2123.                callers have the option of investigating the BBS before
  2124.                deciding to join as an active user.  The default password is
  2125.                "GUEST" (which can be changed in the "BBS Configuration and
  2126.                File Paths" section) and the default phone number is "0000".
  2127.  
  2128.           3    This option specifies the number of minutes before a bell
  2129.                is sounded to alert the user that the system is about to
  2130.                "time out" and hang up.  Handy for users who fall asleep at
  2131.                the keyboard!
  2132.  
  2133.           4    This option specifies the number of minutes that are allowed
  2134.                to pass with no activity before the system "times out" and
  2135.                hangs up.  This value should, obviously, be set higher than
  2136.                the "time out bell" value in option 3!
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.                                    - Page 32 -
  2153.  
  2154.                    PegaSys Main Documentation - Version 0.43
  2155.  
  2156.  
  2157.      --------------------------
  2158.      FILE SECTION CONFIGURATION
  2159.      --------------------------
  2160.  
  2161.      File  Section  Configuration  allows you to  control  various  options
  2162.      associated with the file transfer section.  In addition, it allows the
  2163.      definition and maintenance of PegaSys 's built-in archive manipulation
  2164.      settings, one of the system's most powerful features!
  2165.  
  2166.      Upon selecting this option, the following menu is displayed:
  2167.      ______________________________________________________________________
  2168.  
  2169.      File section configuration
  2170.  
  2171.      A. Archive configuration
  2172.      B. Upload/download ratio           :Active
  2173.      C. Auto file point compensation    :In-active
  2174.      D. File point compensation ratio   :3 to 1
  2175.      E. Base file size per 1 file point :10k
  2176.      F. Upload time refund percent      :100%
  2177.      G. "To-SysOp" file base            :0
  2178.      H. Auto-validate ALL files ULed?   :No
  2179.      I. Remote DOS re-direction device  :COM1
  2180.      J. Max k-bytes allowed in TEMP\3\  :500
  2181.      K. Min k-bytes to save for resume  :100
  2182.  
  2183.      Enter selection (A-K) [Q]uit :
  2184.      ______________________________________________________________________
  2185.  
  2186.      Each option is described in detail below.
  2187.  
  2188.           A    This option takes you into the archive configuration
  2189.                section, which will be discussed in the latter part of this
  2190.                section.
  2191.  
  2192.           B    This option specifies whether or not upload/download ratio
  2193.                checking is active.  If active, a user must have uploaded X
  2194.                amount (in kilobytes) of files in order to download a file.
  2195.  
  2196.           C    This option specifies whether or not automatic file point
  2197.                compensation is active.  If active, files are automatically
  2198.                given X amounts of points per X amount of kilobytes
  2199.                uploaded, as determined by the setting of option D.
  2200.  
  2201.           D    This option works in conjunction with option C, and defines
  2202.                how many points a user is entitled to download in files,
  2203.                divided by the number of points uploaded (works similar to
  2204.                the upload/download ratio system).
  2205.  
  2206.           E    This option also works in conjunction with option C, and
  2207.                defines how many file points should be rewarded for a given
  2208.                upload, based on the number of kilobytes in the given
  2209.                upload.
  2210.  
  2211.           F    This option defines the percentage of time that a user is
  2212.                refunded after uploading a file.  It calculates an amount of
  2213.  
  2214.  
  2215.                                    - Page 33 -
  2216.  
  2217.                    PegaSys Main Documentation - Version 0.43
  2218.  
  2219.  
  2220.                time in hours, minutes and sections, that a user is to have
  2221.                restored to their remaining time online after the upload, as
  2222.                a token from the SysOp.  The default is 100%, or the same
  2223.                amount of time lost uploading the file.  Raising the value
  2224.                will award more time, lowering the value will restore less
  2225.                time.
  2226.  
  2227.                Note that if an event is scheduled during the user's time
  2228.                online, the amount of time is NOT refunded to the user until
  2229.                after the event has taken place (when they next log on).
  2230.  
  2231.           G    This option defines the file base that is designated as
  2232.                "SysOp only".  This is for SysOp-only uploads, performed in
  2233.                the file transfer area by preceding the uploaded file's
  2234.                description with a backslash ("\").  The default is area 0.
  2235.                It is recommended that you set aside area 0 for SysOp-only
  2236.                uploads, because if you define another file area as such,
  2237.                and change this option to point to it, then add or delete
  2238.                other file areas before it, you will have to constantly
  2239.                change this option.
  2240.  
  2241.           H    This option specifies whether or not all uploaded files are
  2242.                to be auto-validated.  This option defaults to NO, which is
  2243.                preferred by many SysOps (that way, they can view the file
  2244.                and determine its worth, and also check it for possible
  2245.                viruses that may cause unwanted anguish to a user or a
  2246.                fellow SysOp).
  2247.  
  2248.           I    This option defines the remote DOS re-direction device.
  2249.                Normally, activity in DOS is tailored for the local user,
  2250.                and a remote who may need to edit a batch file, etc., would
  2251.                have a hardship in doing so.  Thus, a re-direction device
  2252.                will show DOS activity through the CTTY device using the re-
  2253.                direction device.
  2254.  
  2255.                Got all that?  No?  Here's the short version:  It allows
  2256.                both the local and remote users to see what's going on when
  2257.                the remote user has shelled to DOS, as long as a device
  2258.                driver that redirects video output has been installed using
  2259.                CONFIG.SYS.
  2260.  
  2261.                (An excellent driver for this purpose is GATEWAY2.SYS, which
  2262.                is installed using CONFIG.SYS, and can be configured for use
  2263.                with COM1 [GATE1] or COM2 [GATE2].  GATEWAY2.SYS should be
  2264.                available from any local system as GATEWAY2.ZIP; if not, it
  2265.                is available from the PegaSys  Alpha sites.)
  2266.  
  2267.           J    This option defines the maximum number of kilobytes allowed
  2268.                in the temporary archive working directory.
  2269.  
  2270.           K    This option defines the minimum number of kilobytes that
  2271.                must have been sent during an upload before it can be saved
  2272.                for a resume-later upload operation, in the event that the
  2273.                upload is aborted.
  2274.  
  2275.  
  2276.  
  2277.  
  2278.                                    - Page 34 -
  2279.  
  2280.                    PegaSys Main Documentation - Version 0.43
  2281.  
  2282.  
  2283.      ARCHIVE CONFIGURATION
  2284.  
  2285.      As  described  above,  option  A  will  take  you  into  the   archive
  2286.      configuration  section.   This  section defines  the  various  archive
  2287.      formats   supported  by  PegaSys 's  internal   archive   manipulation
  2288.      functions.   These functions will, among other  things,  automatically
  2289.      convert  uploaded  files  from  one archive  format  to  another  (for
  2290.      example,  convert to ZIP format all archives uploaded in ARC  format).
  2291.      It  is a feature that, until now, has not existed on any BBS  software
  2292.      package!  (See the "File Base Editor" section for more information  on
  2293.      this feature.)
  2294.  
  2295.      Upon selection, the following menu is displayed:
  2296.      ______________________________________________________________________
  2297.  
  2298.      Archive configuration edit
  2299.  
  2300.      1. Archive comment: PegaSys  BBS  000-000-0000
  2301.      2. Archive comment: *None*
  2302.      3. Archive comment: *None*
  2303.  
  2304.       NN:Ext:Compression cmdline     :Decompression cmdline :Success Code
  2305.       ==:===:========================:======================:============
  2306.      +1  ZIP PKZIP -aex @F @I         PKUNZIP @F @I           0
  2307.      -2  ARC PKPAK a @F @I            PKUNPAK @F @I           0
  2308.      -3  ZOO ZOO aP: @F @I            ZOO x @F @I             0
  2309.      -4  PAK PAK a @F @I              PAK e @F @I             -1 (ignores)
  2310.      -5  LZH LHARC A @F @I            LHARC X @F @I           0
  2311.  
  2312.      Archive edit (Q,?=help) :
  2313.      ______________________________________________________________________
  2314.  
  2315.      Pressing "?" will display the functions allowed at this menu:
  2316.  
  2317.           <CR>Redisplay screen
  2318.           1-3:Archive comments
  2319.           (I)nsert archive  (D)elete archive
  2320.           (M)odify archives (Q)uit and save
  2321.  
  2322.      Each option is described below:
  2323.  
  2324.           1-3:Archive comments -- Allows the definition of up to three
  2325.                different archive comments, which can be added to archive
  2326.                files automatically after they have been uploaded.  Note
  2327.                that not all archive formats support archive comments.
  2328.  
  2329.           (I)nsert archive -- Creates a new entry in the archive format
  2330.                table.
  2331.  
  2332.           (D)elete archive -- Remove an entry from the archive format
  2333.                table.
  2334.  
  2335.           (M)odify archives -- Allows modification of the archive format
  2336.                table entries (more on that later).
  2337.  
  2338.           (Q)uit and save -- Saves the table and returns to the File
  2339.  
  2340.  
  2341.                                    - Page 35 -
  2342.  
  2343.                    PegaSys Main Documentation - Version 0.43
  2344.  
  2345.  
  2346.                Section Configuration menu.
  2347.  
  2348.      When  you select the (M)odify command, you will be asked which  format
  2349.      you  wish  to modify.  After you select one, the following  screen  is
  2350.      displayed (the ZIP format is used as an example):
  2351.      ______________________________________________________________________
  2352.  
  2353.      Archive #1 of 5
  2354.  
  2355.      1. Active                 : Yes
  2356.      2. Extension name         : ZIP
  2357.      3. Interior list method   : "/1" - *Internal* ZIP viewer
  2358.      4. Compression cmdline    : PKZIP -aex @F @I
  2359.      5. Decompression cmdline  : PKUNZIP @F @I
  2360.      6. Integrity check cmdline: PKUNZIP -t @F
  2361.      7. Add comment cmdline    : PKZIP -z @F
  2362.      8. Errorlevel for success : 0
  2363.      Q. Quit
  2364.  
  2365.      Edit menu: (1-8,[,],Q) :
  2366.      ______________________________________________________________________
  2367.  
  2368.      The  "["  and "]" keys will allow you to move back and  forth  between
  2369.      each entry in the archive format table.  Options 1-8 are described  in
  2370.      detail   below.   Pressing  "Q"  will  return  you  to   the   Archive
  2371.      Configuration Edit screen.
  2372.  
  2373.           1    This option specifies whether or not the archive format is
  2374.                active.  If inactive, then PegaSys  will not allow any
  2375.                operation on archive files in this format, such as integrity
  2376.                checking or viewing its contents (the uploading of such
  2377.                files, however, will not be impaired).
  2378.  
  2379.           2    This option specifies the extension used for files saved in
  2380.                the particular archive format.  For example, "ZIP" is used
  2381.                as an extension for archive files created by the PKZIP
  2382.                archiving program.  In common usage, the file extension
  2383.                usually describes the archive format itself (ZIP format, ARC
  2384.                format, ZOO format, etc.).
  2385.  
  2386.           3    This option defines the method used to view the contents of
  2387.                archive files in the particular format.  The following
  2388.                entries are allowed:
  2389.  
  2390.                     /1 - Uses the internal ZIP file viewer
  2391.                     /2 - Uses the internal ARC/PAK file viewer
  2392.                     /3 - Uses the internal ZOO file viewer
  2393.                     /4 - Uses the internal LZH file viewer
  2394.  
  2395.                If you have defined an archive format that is not supported
  2396.                internally, you may use this option to define the command
  2397.                line required to view the archive's contents, using the
  2398.                actual archiving program itself (which usually provides a
  2399.                method of viewing the contents of archives it creates).  The
  2400.                archiving program must reside somewhere in your DOS PATH in
  2401.                order for this feature to work.
  2402.  
  2403.  
  2404.                                    - Page 36 -
  2405.  
  2406.                    PegaSys Main Documentation - Version 0.43
  2407.  
  2408.  
  2409.                When defining the command line, substitute the "@F" MCI
  2410.                where the actual archive filename  would normally be placed.
  2411.                PegaSys  will automatically replace the MCI with the
  2412.                intended filename.
  2413.  
  2414.           4    This option defines the command line used to create or
  2415.                update an archive file using this format, using the actual
  2416.                archiving program itself.  The archiving program must reside
  2417.                somewhere in your DOS PATH in order for this feature to
  2418.                work.
  2419.  
  2420.                When defining the command line, substitute the "@F" and "@I"
  2421.                MCIs where the actual archive filename and file to be
  2422.                archived, respectively, would normally be placed.  PegaSys
  2423.                will automatically replace the MCIs with the proper
  2424.                information.  Consult the documentation for the particular
  2425.                archiving program for the command line options required to
  2426.                create or update an archive file.
  2427.  
  2428.           5    This option is similar to option 4, except that it defines
  2429.                the command line used to extract files from an archive file.
  2430.                All rules and restrictions mentioned above also apply.
  2431.  
  2432.           6    This option is also  similar to  option 4, except that it
  2433.                defines the command line used to check the integrity of an
  2434.                archive file.  All rules and restrictions mentioned above
  2435.                also apply (except that the "@I" MCI will more than likely
  2436.                not be needed).  If the archiving program does not support
  2437.                integrity testing, this option can be set to NULL (in which
  2438.                case the BBS will not check the integrity of the archive
  2439.                file after it has been uploaded).
  2440.  
  2441.           7    This option is also similar to option 4, except that it
  2442.                defines the command line used to add a comment to an archive
  2443.                file.  All rules and restrictions mentioned above also apply
  2444.                (except that, as in option 6, the "@I" MCI will more than
  2445.                likely not be needed).  If the archiving program and/or
  2446.                archive format does not support archive comments, this
  2447.                option should be set to NULL.
  2448.  
  2449.           8    This option defines the ERRORLEVEL value that the archiving
  2450.                program returns when an operation has been successfully
  2451.                completed.  Most archiving programs return an ERRORLEVEL of
  2452.                0 in this case.  However, some do not return an ERRORLEVEL
  2453.                value at all.  In situations like these, setting this option
  2454.                to "-1" will ignore any value returned from the program, and
  2455.                assume that all operations were successful.
  2456.  
  2457.  
  2458.  
  2459.  
  2460.  
  2461.  
  2462.  
  2463.  
  2464.  
  2465.  
  2466.  
  2467.                                    - Page 37 -
  2468.  
  2469.                    PegaSys Main Documentation - Version 0.43
  2470.  
  2471.  
  2472.      -----------------------------------
  2473.      NEW USER & AUTO-VALIDATION SETTINGS
  2474.      -----------------------------------
  2475.  
  2476.      This  section  defines the security levels and flags  given  to  users
  2477.      before and after they have been validated.
  2478.  
  2479.      Upon selecting this option, the following screen is displayed:
  2480.      ______________________________________________________________________
  2481.  
  2482.      New user configuration             Auto-validation command
  2483.  
  2484.      A. SL :20                          F. SL :50
  2485.      B. DSL:20                          G. DSL:50
  2486.      C. AR :--------------------------  H. AR :--------------------------
  2487.      D. AC :-----*--K-/----             I. AC :----------/----
  2488.      E. #FP:0
  2489.  
  2490.      Enter selection (A-I) [Q]uit :
  2491.      ______________________________________________________________________
  2492.  
  2493.      Each option is described in detail below.
  2494.  
  2495.           A    This option defines the security level (SL) of a new user,
  2496.                which is the status they are trusted with as user and is
  2497.                usually periodically upgraded as the individual proves
  2498.                himself worthy of higher access.  This is the beginning
  2499.                access level on your BBS, before a user is validated.
  2500.  
  2501.           B    This option defines the download security level (DSL) of a
  2502.                new user.  The DSL is analogous to the SL, except that it is
  2503.                used primarily in the file transfer section.
  2504.  
  2505.           C    This option defines the area flags (AR flags) for a new
  2506.                user.  PegaSys  currently has 26 AR flags, which correspond
  2507.                to the letters of the alphabet (A-Z).  They are used for
  2508.                special accesses, like special interest groups (SIGs), high
  2509.                security file bases, text file areas, etc.  For the most
  2510.                part, a new users should not have ANY access to these
  2511.                features until you have reviewed their information and
  2512.                validation letter to determine what their interests are.
  2513.                When used in conjunction with the ACS system, AR flags can
  2514.                create a powerful security and special-interest system.
  2515.  
  2516.           D    This option defines the access flags (AC flags) for a new
  2517.                user.  AC flags are rather generic in nature, and not
  2518.                configurable like the AR flags.  They are designed for both
  2519.                "problem users" and "special users".  As a SysOp, from time
  2520.                to time you will run into persons who abuse features of the
  2521.                system, and without lowering their access level, AC flags
  2522.                are the GREAT denominator.  The possible flags available at
  2523.                any given time are as follows:
  2524.  
  2525.                     LCVBA*PEKM/1234
  2526.  
  2527.                However, no user will have all of these, as the first subset
  2528.  
  2529.  
  2530.                                    - Page 38 -
  2531.  
  2532.                    PegaSys Main Documentation - Version 0.43
  2533.  
  2534.  
  2535.                consists of "penalty" flags, whereas the second subset
  2536.                consists of "reward" flags.  Each flag is defined as
  2537.                follows:
  2538.  
  2539.                L    Can logon ONLY once/day -- Does not allow a given
  2540.                          caller to have more than one BBS logon in a given
  2541.                          day.  Used for callers who tie up your BBS all day
  2542.                          and don't allow other callers a fair opportunity
  2543.                          for system time.
  2544.  
  2545.                C    Can't page SysOp -- Does not allow the caller to use
  2546.                          the CHAT commands throughout the BBS.  Some
  2547.                          callers choose to constantly page the SysOp for
  2548.                          rather unimportant reasons; they become extremely
  2549.                          annoying, as well as extremely time consuming!
  2550.  
  2551.                V    Posts marked unvalidated -- Marks all public messages
  2552.                          as "unvalidated" until the SysOp decides to
  2553.                          either validate or delete them.  Used for callers
  2554.                          who leave abusive or off-topic messages, despite
  2555.                          repeated warnings to the contrary.
  2556.  
  2557.                B    Back/downspacing restricted -- Back/downspacing is a
  2558.                          PegaSys  MCI subset that allows the user to do
  2559.                          various "tricks", such as spinning the cursor and
  2560.                          moving the cursor all over the screen.  This flag
  2561.                          is used to prevent callers from tying up the
  2562.                          message base with fancy, yet childish (and
  2563.                          useless) posts.
  2564.  
  2565.                A    Can't add to BBS list -- This flag prevents the caller
  2566.                          from using the (A)dd command in the BBS list menu.
  2567.                          Primarily used for callers who keep adding the
  2568.                          same BBS, false boards, voice phone numbers, etc.
  2569.                          to the BBS list.
  2570.  
  2571.                *    Can't post/send anon. -- This flag prevents the caller
  2572.                          from being able to post public or Email messages
  2573.                          anonymously.  Used for callers who like to
  2574.                          verbally assault other users; with this
  2575.                          restriction, all parties are aware of EXACTLY who
  2576.                          posts the message(s) in question.
  2577.  
  2578.                P    Can't post at all -- This flag prevents a user from
  2579.                          posting any messages in the message base.  Used
  2580.                          for callers who abuse the message bases wither
  2581.                          with blank posts on a post/call ratio oriented
  2582.                          system, excessive profanity, inane comments,
  2583.                          verbal assaults, etc.
  2584.  
  2585.                E    Can't send Email -- This flag prevents the caller from
  2586.                          sending ANY Email to another user.  Used for
  2587.                          callers who harass other users and don't stop,
  2588.                          despite SysOp intervention.
  2589.  
  2590.  
  2591.  
  2592.  
  2593.                                    - Page 39 -
  2594.  
  2595.                    PegaSys Main Documentation - Version 0.43
  2596.  
  2597.  
  2598.                K    Can't vote -- Does not allow the caller to have access
  2599.                          to the voting booth.  Basically, this is the most
  2600.                          harmless restriction, as only the SysOp and
  2601.                          trusted users have designed the voting questions
  2602.                          (however, some users don't deserve ANY breaks!
  2603.                          <hehehe>).
  2604.  
  2605.                M    Automatic mail deletion -- This flag will force the BBS
  2606.                          to automatically delete a caller's Email.
  2607.                          Primarily used as a harassment tool for persons
  2608.                          who have previously abused the Email system and
  2609.                          have lost the privilege.
  2610.  
  2611.                1    No UL/DL ratio check -- This flag will suppress the
  2612.                          mandatory upload/download ratio check.  Used for
  2613.                          favored callers as a reward, and for remote
  2614.                          SysOps.
  2615.  
  2616.                2    No post/call ratio check -- This flag will suppress the
  2617.                          post/call ratio check on systems which implement
  2618.                          this feature.  Used for remotes who may have other
  2619.                          important tasks, such as user and file
  2620.                          validations, and it proves to be a hindrance.
  2621.  
  2622.                3    No file points check -- This flag will suppress the
  2623.                          checking of a user's file points when requesting a
  2624.                          download of a file.  Used as a reward to a good
  2625.                          uploader on a file points oriented system, or to a
  2626.                          remote.
  2627.  
  2628.                4    Protection from deletion -- This flag will prevent a
  2629.                          user's account from being deleted, until it is
  2630.                          toggled off.  Good for the SysOp, remote SysOps,
  2631.                          message base SysOps and all other high security
  2632.                          users.
  2633.  
  2634.           E    This option sets the initial number of file points awarded
  2635.                to new users.  The value here is determined, basically, by
  2636.                the generosity of the SysOp!
  2637.  
  2638.           F    This option sets the SL value for a validated user.  This
  2639.                value should be greater than that of a new users, because
  2640.                they passed your ideals of what a valid user should be.
  2641.                Permits higher access in the message base and other areas of
  2642.                the system.
  2643.  
  2644.           G    This option is similar to option F, except that it pertains
  2645.                to the DSL value.  Permits higher access in the file
  2646.                transfer section.
  2647.  
  2648.           H    This option defines the AR flags for a validated user.  See
  2649.                option C above for a complete description of AR flags.
  2650.  
  2651.           I    This option defines the AC flags for a validated user.  See
  2652.                option D above for a complete description of AC flags.
  2653.  
  2654.  
  2655.  
  2656.                                    - Page 40 -
  2657.  
  2658.                    PegaSys Main Documentation - Version 0.43
  2659.  
  2660.  
  2661.      ---------------------------
  2662.      MISCELLANEOUS CONFIGURATION
  2663.      ---------------------------
  2664.  
  2665.      This section is for miscellaneous configuration options that don't fit
  2666.      anywhere else in the System Configuration.
  2667.  
  2668.      Upon selecting this option, the following menu is displayed:
  2669.      ______________________________________________________________________
  2670.  
  2671.      Miscellaneous configuration
  2672.  
  2673.      A. System start-out menu       :MAIN
  2674.      B. SysOp chat color-filter     :
  2675.      C. User chat color-filter      :
  2676.      D. Default bulletin prefix file:BULLET
  2677.  
  2678.      Enter selection (A-D) [Q]uit :
  2679.      ______________________________________________________________________
  2680.  
  2681.      Each option is described in detail below.
  2682.  
  2683.           A    This option defines the menu that is loaded first when a
  2684.                user logs on, which must be defined and must reside in the
  2685.                MENUS directory.  The default is MAIN, or the main menu.
  2686.                This option is useful for forcing users to start out at a
  2687.                different menu (the file transfer menu, the on-line programs
  2688.                menu, a user-defined menu, etc.).
  2689.  
  2690.           B    This option defines the color filter configuration file used
  2691.                during chat for the SysOp's input.  The file must reside in
  2692.                the AFILES directory.  If undefined, the SysOp chat color
  2693.                defined in the General Variables section is used.
  2694.  
  2695.           C    This option is similar to option B, except that it defines
  2696.                the color filter configuration file used during chat for the
  2697.                user's input.  Same rules and restrictions apply.
  2698.  
  2699.           D    This option defines the prefix name used for bulletin files.
  2700.                One to seven characters may be input, which would allow for
  2701.                seven- to one-character selections at the bulletin menu.
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715.  
  2716.  
  2717.  
  2718.  
  2719.                                    - Page 41 -
  2720.  
  2721.                    PegaSys Main Documentation - Version 0.43
  2722.  
  2723.  
  2724.      ---------------------
  2725.      FIDONET CONFIGURATION
  2726.      ---------------------
  2727.  
  2728.      This  section  defines the information required for  use  by  external
  2729.      FidoNet  message  processing utilities.  This  includes  your  FidoNet
  2730.      address,  a  default origin line, and options used  when  tossing  and
  2731.      scanning messages.  (If you are not a FidoNet node, then you can  skip
  2732.      this  information.)  Except for the FidoNet address,  all  information
  2733.      specified  here is used as defaults when creating a new  message  base
  2734.      (and, in the case of the origin line, if an individual origin line  is
  2735.      not specified).
  2736.  
  2737.      Upon selecting this option, the following menu is displayed:
  2738.      ______________________________________________________________________
  2739.  
  2740.      FidoNet configuration
  2741.  
  2742.      A. FidoNet address : 0:0/0.0
  2743.      B. Origin line     : PegaSys  BBS
  2744.  
  2745.      C. Strip IFNA kludge lines : Yes     1. Color of standard text : 1
  2746.      D. Strip SEEN-BY lines     : Yes     2. Color of quoted text   : 3
  2747.      E. Strip origin lines      : No      3. Color of tear line     : 9
  2748.      F. Strip centering codes   : Yes     4. Color of origin line   : 5
  2749.      G. Strip box codes         : Yes
  2750.      H. Center box/center lines : Yes
  2751.      I. Add tear/origin lines   : Yes
  2752.  
  2753.      Enter selection (A-I,1-4) [Q]uit :
  2754.      ______________________________________________________________________
  2755.  
  2756.      Each option is described in detail below.
  2757.  
  2758.           A    Defines your given FidoNet address.  You will be prompted
  2759.                for each individual component of the address (zone, net,
  2760.                node and point numbers); pressing [ENTER] at any prompt will
  2761.                leave that component unchanged.
  2762.  
  2763.                The FidoNet address is displayed in various places in the
  2764.                system (including the "Welcome to..." line during logon).
  2765.                However, if the net number is equal to "0", then the address
  2766.                is NOT displayed (since there is no such thing as Net 0 in
  2767.                FidoNet).
  2768.  
  2769.           B    Defines the origin line placed at the bottom of outgoing
  2770.                messages.  Do not put your FidoNet address in the origin
  2771.                line; PegaSys  (as well as external message processing
  2772.                utilities) will add it automatically.  This origin line is
  2773.                used if an individual origin line is not specified for a
  2774.                message base (and if THIS origin line isn't defined, then
  2775.                the first 50 characters of the BBS name are used).
  2776.  
  2777.           C    Toggles stripping of IFNA kludge lines from incoming
  2778.                messages.  Kludge lines begin with the ^A code (1 decimal),
  2779.                and are not normally needed.  Applicable to both EchoMail
  2780.  
  2781.  
  2782.                                    - Page 42 -
  2783.  
  2784.                    PegaSys Main Documentation - Version 0.43
  2785.  
  2786.  
  2787.                and GroupMail bases.
  2788.  
  2789.           D    Toggles stripping of SEEN-BY lines from incoming messages.
  2790.                SEEN-BY lines define which nodes have received the message,
  2791.                and are not normally needed once the message has been
  2792.                received.  Useful only for EchoMail bases, as GroupMail
  2793.                messages don't have SEEN-BY lines.
  2794.  
  2795.           E    Toggles stripping of origin lines from incoming messages.
  2796.                The origin line identifies the system that originated the
  2797.                message, and is usually desirable.  Applicable to both
  2798.                EchoMail and GroupMail bases (though GroupMail messages
  2799.                aren't required to have origin lines).
  2800.  
  2801.           F    Toggles stripping of "center line" codes from lines in
  2802.                outgoing messages.  The centering code (^B, or 2 decimal)
  2803.                tells PegaSys  to display the line in the center of the
  2804.                screen according to the current screen width.  Unless you
  2805.                are communicating strictly with another PegaSys  system,
  2806.                this code has no meaning in FidoNet messages.  Applicable to
  2807.                both EchoMail and GroupMail bases.
  2808.  
  2809.           G    Toggles stripping of "box line" codes from lines in outgoing
  2810.                messages.  The box code ("`#[") tells PegaSys  to enclose
  2811.                the text in a box, centered on the screen according to the
  2812.                current screen width.  Unless you are communicating strictly
  2813.                with another PegaSys  system, this code has no meaning in
  2814.                FidoNet messages.  Applicable to both EchoMail and GroupMail
  2815.                bases.
  2816.  
  2817.           H    Toggles centering of boxed/centered lines in outgoing
  2818.                messages.  If enabled, lines that start with a box or center
  2819.                code will be centered on an 80-column line by padding the
  2820.                line to the left with spaces.  (This is only done if box
  2821.                and/or centering codes are being stripped.)  Applicable to
  2822.                both EchoMail and GroupMail bases.
  2823.  
  2824.           I    Toggles the automatic addition of tear and origin lines to
  2825.                messages posted in FidoNet bases.  The tear line will use
  2826.                the BBS version number ("--- PegaSys  v2.5", for example).
  2827.                Applicable mainly to GroupMail bases, as GroupMail messages
  2828.                aren't required to have tear and origin lines (they are
  2829.                mandatory, however, for EchoMail messages).
  2830.  
  2831.           1    Defines the color used to display normal text.  The default
  2832.                is MCI color #1 (cyan in the default setup).  Applicable to
  2833.                both EchoMail and GroupMail bases.
  2834.  
  2835.           2    Defines the color used to display quoted text.  Quoted text
  2836.                lines usually start with a ">" character, and serve to
  2837.                quote portions of a previous message.  If the line contains
  2838.                a ">" character anywhere in positions 1 through 5, it is
  2839.                displayed using this color, which defaults to MCI color #3
  2840.                (bright cyan in the default setup).  Applicable to both
  2841.                EchoMail and GroupMail bases.
  2842.  
  2843.  
  2844.  
  2845.                                    - Page 43 -
  2846.  
  2847.                    PegaSys Main Documentation - Version 0.43
  2848.  
  2849.  
  2850.           3    Defines the color used to display the tear line.  The tear
  2851.                line defines the program used to process the message on the
  2852.                originating system; it begins with "--- ", followed by the
  2853.                name of the program.  The default is MCI color #9 (bright
  2854.                green in the default setup).  Applicable to both EchoMail
  2855.                and GroupMail bases (though GroupMail messages aren't
  2856.                required to have a tear line).
  2857.  
  2858.           4    Defines the color used to display the origin line.  As
  2859.                explained above, the origin line identifies the system that
  2860.                the message originated on; it begins with " * Origin: ",
  2861.                followed by a message defined by the SysOp of the
  2862.                originating system.  The default is color #5 (yellow in the
  2863.                default setup).  Applicable to both EchoMail and GroupMail
  2864.                bases (though GroupMail messages aren't required to have an
  2865.                origin line).
  2866.  
  2867.  
  2868.  
  2869.  
  2870.  
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.                                    - Page 44 -
  2909.  
  2910.                    PegaSys Main Documentation - Version 0.43
  2911.  
  2912.  
  2913.      --------------------
  2914.      STRING CONFIGURATION
  2915.      --------------------
  2916.  
  2917.      This section will allow you to add different colors and special  codes
  2918.      to,  and  generally  change the appearance of,  many  of  the  strings
  2919.      displayed throughout the system.  The String Configuration section  is
  2920.      currently  comprised of five (5) pages of information; upon  selecting
  2921.      this option, the first page will be displayed.
  2922.  
  2923.      Following  is a display of all five pages, with descriptions  of  each
  2924.      field.  Three command keys are available at all screens:  "[" to  move
  2925.      to  the  previous screen, "]" to move to the next screen, and  "Q"  to
  2926.      return  to  the  System  Configuration  section.   With  only  a   few
  2927.      exceptions,  all  strings  defined below have a maximum  limit  of  80
  2928.      characters,  and  may contain ASCII text, MCI commands  or  MCI  color
  2929.      codes.
  2930.  
  2931.      ______________________________________________________________________
  2932.  
  2933.      String configuration - page 1 of 5
  2934.  
  2935.      A. Ansi logon Q.:Display ANSI logon?
  2936.      B. Logon note #1:Enter your PegaSys  NAME or USER NUMBER
  2937.         Logon note #2:* NEW USERS, enter "NEW" *
  2938.      C. Logon prompt :Logon :
  2939.      D. Echo chr     :X
  2940.      E. SysOp IN     :The SysOp is probably around!
  2941.      F. SysOp OUT    :The SysOp is NOT here, or doesn't want to chat
  2942.      G. Engage chat  :@MThe SysOp brings you into chat!
  2943.      H. Exit chat    :The SysOp returns you to the BBS....@M
  2944.      I. SysOp working:{-Please Wait-}
  2945.      J. Pause screen :(* pause *)
  2946.  
  2947.      Enter selection (A-J,[,]),(Q)uit :
  2948.      ______________________________________________________________________
  2949.  
  2950.           A    This question is asked of ALL callers, both off-site and
  2951.                local (except when the SysOp is in fast logon mode).  If the
  2952.                user enters "Yes", an ANSI picture (WELCOME.ANS) is
  2953.                displayed.  If the user enters "No", a text file
  2954.                (WELCOME.MSG) is displayed.
  2955.  
  2956.           B    These lines are provided as an aid to callers, especially to
  2957.                new users to a PegaSys  system who may not know how to log
  2958.                on as a new user.
  2959.  
  2960.           C    This is displayed just before the input area, and is usually
  2961.                a prompt such as "Logon:" that lets the caller know that the
  2962.                system is ready to log them on.
  2963.  
  2964.           D    This is the character that is echoed to the screen when the
  2965.                caller types his password and phone number.  Designed as a
  2966.                security feature so nobody standing behind the caller's back
  2967.                can steal their account.
  2968.  
  2969.  
  2970.  
  2971.                                    - Page 45 -
  2972.  
  2973.                    PegaSys Main Documentation - Version 0.43
  2974.  
  2975.  
  2976.           E    This string tells the user that the SysOp is available and
  2977.                ready to chat.  This is displayed ONLY during the defined
  2978.                chat hours (defined in the "BBS Configuration and File
  2979.                Paths" section).
  2980.  
  2981.           F    This string is displayed when the SysOp is not available to
  2982.                chat (or doesn't wish to!).  It works according to the
  2983.                defined chat hours and is displayed at all times EXCEPT
  2984.                during chat hours.
  2985.  
  2986.           G    This string is displayed when the SysOp has engaged the Chat
  2987.                mode.
  2988.  
  2989.           H    This string is displayed as the SysOp disengages the Chat
  2990.                mode.
  2991.  
  2992.           I    This string is displayed when the SysOp is performing a
  2993.                function while a user is online (such as editing a user's
  2994.                security information).
  2995.  
  2996.           J    This works off the default screen size, established during
  2997.                the new user logon (and configurable at the Personal
  2998.                Information menu).  For instance, the default number of
  2999.                lines on an IBM-compatible system is 25.  So, after every 25
  3000.                lines of text is printed, the user is temporarily paused to
  3001.                allow viewing of the text.  This message is displayed when
  3002.                the pause is active; pressing [ENTER] releases the pause and
  3003.                continues normal operations.
  3004.      ______________________________________________________________________
  3005.  
  3006.      String configuration - page 2 of 5
  3007.  
  3008.      A. Message entry L#1:Enter message now.  You have @X lines maximum.
  3009.      B. Message entry L#2:Enter /S to save.  /? for a list of commands.
  3010.      C. NewScan start    :[@Y - @W msgs] NewScan began.@M
  3011.      D. NewScan done     :[@Y - @W msgs] NewScan complete.@M
  3012.      E. Read msgs prompt :[@Y]@M[@U] Read (1-@W,<CR>,T,Q,P,A,R,B,W,D) :
  3013.      F. Automessage by   :AutoMessage by:
  3014.      G. Auto border char.:-
  3015.  
  3016.      Enter selection (A-G,[,]),(Q)uit :
  3017.      ______________________________________________________________________
  3018.  
  3019.           A    This is the first line of the description for entering
  3020.                public messages and Email, displayed just after the header
  3021.                information is entered.
  3022.  
  3023.           B    This is the second line of the description for entering
  3024.                public messages and Email.  Both lines may contain color and
  3025.                MCI commands.
  3026.  
  3027.           C    This message is displayed at the start of each message base
  3028.                during a global NewScan for new messages.
  3029.  
  3030.           D    This message is displayed at the end of each message base
  3031.                during a global NewScan for new messages.
  3032.  
  3033.  
  3034.                                    - Page 46 -
  3035.  
  3036.                    PegaSys Main Documentation - Version 0.43
  3037.  
  3038.  
  3039.           E    This prompt is displayed after each scanned or NewScanned
  3040.                message, and provides a list of available commands that may
  3041.                be used in the reading of messages.
  3042.  
  3043.           F    This message is displayed as the header of the automessage.
  3044.                It can be either straight ASCII text, or colorized text
  3045.                using the MCI colors.
  3046.  
  3047.           G    This character is a straight uncolored ASCII character.  It
  3048.                surrounds the text in the automessage at both the top and
  3049.                the bottom of the message.
  3050.      ______________________________________________________________________
  3051.  
  3052.      String configuration - page 3 of 5
  3053.  
  3054.      A. Shell to DOS L#1 :>> System Operator has Shelled to DOS, please wai
  3055.      t ...
  3056.      B. Shell to DOS L#2 :>> Thank you for waiting
  3057.      C. Chat call L#1    :Paging System Operator for chat, please wait.....
  3058.      D. Chat call L#2    : >><*><<
  3059.      E. Guest user info  :Enter "GUEST" as your user name to be a guest use
  3060.      r on the system.
  3061.      F. Name not found   :That name is NOT found in the user list.
  3062.      G. Bulletin line    :Enter Bulletin Selection (XX,?,Q=Quit) :
  3063.      H. Thanks for voting:Thanks for taking the time to vote!
  3064.  
  3065.      Enter selection (A-H,[,]),(Q)uit :
  3066.      ______________________________________________________________________
  3067.  
  3068.           A    This message is displayed when the SysOp has performed a
  3069.                local shell to DOS.  While the SysOp is in DOS, the caller
  3070.                is prevented from doing anything.
  3071.  
  3072.           B    This message is displayed when the SysOp has returned from
  3073.                dropping to DOS.
  3074.  
  3075.           C    This message is displayed when a user pages the SysOp for
  3076.                chat during declared chat hours.
  3077.  
  3078.           D    This message is displayed while the BBS is paging the SysOp
  3079.                during chat hours.  It is displayed nine times, with a beep
  3080.                occurring once prior to each display and once after.  A high
  3081.                pitched beeping sound on the local end is used to alert the
  3082.                SysOp that a user wishes to chat.
  3083.  
  3084.           E    This line is displayed with the logon lines at the time of
  3085.                logon, if a guest user account has been defined (see the
  3086.                "General Flagged Functions" section for more information
  3087.                about this feature).
  3088.  
  3089.           F    This message is displayed if the user name entered during
  3090.                the logon process is not present in the NAMES.LST file.  It
  3091.                serves to warn the user that either they entered their name
  3092.                wrong, or they have not signed onto the BBS before.
  3093.  
  3094.  
  3095.  
  3096.  
  3097.                                    - Page 47 -
  3098.  
  3099.                    PegaSys Main Documentation - Version 0.43
  3100.  
  3101.  
  3102.           G    This message is displayed below the list of the BBS
  3103.                bulletins.  It contains commands that are present in the
  3104.                bulletin menu.
  3105.  
  3106.           H    This string is displayed after a user has accessed the
  3107.                voting booth and changed one ore more questions, or answered
  3108.                new questions.
  3109.      ______________________________________________________________________
  3110.  
  3111.      String configuration - page 4 of 5
  3112.  
  3113.      A. List line        :List files - P to pause
  3114.      B. File NewScan line:Search for new files -
  3115.      C. Search line      :Search all directories for a file mask -
  3116.      D. Find Descrip. L#1:Search descriptions and filenames for a keyword -
  3117.      E. Find Descrip. L#2:Enter the string to search for:
  3118.      F. Download line    :Download - You have @P file points.
  3119.      G. Upload line      :Upload - @Kk free on this drive
  3120.      H. View content line:View archive interior files -@MP to Pause, N for
  3121.      Next file
  3122.      I. Insuff. file pts :Access denied: Insufficient points to download.
  3123.      J. Bad UL/DL ratio  :Access denied: Your UL/DL ratio is out of balance
  3124.      :
  3125.  
  3126.      Enter selection (A-J,[,]),(Q)uit :
  3127.      ______________________________________________________________________
  3128.  
  3129.           A    This message is displayed when the user selects the command
  3130.                to list files at the file transfer menu.
  3131.  
  3132.           B    This message is displayed when the user selects the command
  3133.                to scan for new files at the file transfer menu.
  3134.  
  3135.           C    This message is displayed when a user searches for a
  3136.                particular file or files.
  3137.  
  3138.           D    This is the first line of the message that is displayed when
  3139.                a user selects the command to search for a text string to
  3140.                match a description or filename at the file transfer menu.
  3141.  
  3142.           E    This is the second line of the message described in option
  3143.                D.
  3144.  
  3145.           F    This message is displayed when a user attempts to download a
  3146.                file in either regular or batch mode.
  3147.  
  3148.           G    This message is displayed when a user attempts to upload a
  3149.                file in either regular or batch mode.
  3150.  
  3151.           H    This message is displayed when a user attempts to view the
  3152.                contents of an archive file available for downloading.
  3153.  
  3154.           I    This message is displayed when a user attempts to download a
  3155.                file that is worth more file points than they have credit
  3156.                for.  Used only on BBSes that use the file point system.
  3157.  
  3158.  
  3159.  
  3160.                                    - Page 48 -
  3161.  
  3162.                    PegaSys Main Documentation - Version 0.43
  3163.  
  3164.  
  3165.           J    This message is displayed when a user attempts to download a
  3166.                file when their upload/download ratio is out of balance.
  3167.                Used only on BBSes that use the UL/DL ratio system.
  3168.      ______________________________________________________________________
  3169.  
  3170.      String configuration - page 5 of 5
  3171.  
  3172.      A. P/N file info    :P to Pause, N for next directory.
  3173.      B. Get filespec L#1 :[Enter]=All files
  3174.      C. Get filespec L#2 :File mask:
  3175.      D. Add to batch     :File added to batch queue.
  3176.  
  3177.      Enter selection (A-D,[,]),(Q)uit :
  3178.      ______________________________________________________________________
  3179.  
  3180.           A    This message is displayed when a NewScan of the file bases
  3181.                has begun.  Pressing "P" will pause during a file listing.
  3182.                Pressing "N" will stop the current base being scanned and
  3183.                start scanning the next available file base, if present.
  3184.  
  3185.           B    This is the first line of the message displayed when a file
  3186.                search is being attempted.
  3187.  
  3188.           C    This is the second line of the message displayed when a file
  3189.                search is being attempted.
  3190.  
  3191.           D    This message is displayed when a user has added a file to
  3192.                the upload or download queue for batch uploading or
  3193.                downloading.
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.                                    - Page 49 -
  3224.  
  3225.                    PegaSys Main Documentation - Version 0.43
  3226.  
  3227.  
  3228.      --------------
  3229.      DEFAULT COLORS
  3230.      --------------
  3231.  
  3232.      This option is used to edit the colors for prompts, messages, etc., to
  3233.      add color and attractiveness to your BBS.  You can edit either  black-
  3234.      and-white  or ANSI colors.  The default colors are the ones  used  for
  3235.      new  users;  once set, the user can change his  defined  colors  while
  3236.      online.
  3237.  
  3238.      Below is a list of the standard color table:
  3239.  
  3240.           0. Other            Used for miscellaneous messages
  3241.           1. Default          Used for public message and Email text
  3242.           2. Unused           Unused
  3243.           3. Yes/No           Used for responses to Yes/No questions
  3244.           4. Prompts          Used for prompts
  3245.           5. Note             Used for file descriptions
  3246.           6. Input line       Used for keyboard input responses
  3247.           7. Y/N question     Used for Yes/No prompts
  3248.           8. Blinking         Used for unvalidated files and warnings
  3249.           9. Other            Used for miscellaneous messages
  3250.  
  3251.      The  color  editor itself is pretty self-explanatory, so  the  details
  3252.      will  not  be  presented here.  (In a nutshell,  both  foreground  and
  3253.      background  colors, and blinking, can be selected from the  full  ANSI
  3254.      color  set for each of the ten items in the color table.)  Suffice  it
  3255.      to  say  that  experimentation is in order if you  wish  to  redo  the
  3256.      standard color scheme, until you attain a combination to your liking.
  3257.  
  3258.  
  3259.  
  3260.  
  3261.  
  3262.  
  3263.  
  3264.  
  3265.  
  3266.  
  3267.  
  3268.  
  3269.  
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.  
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.                                    - Page 50 -
  3287.  
  3288.                    PegaSys Main Documentation - Version 0.43
  3289.  
  3290.  
  3291.      ----------------
  3292.      TIME LIMITATIONS
  3293.      ----------------
  3294.  
  3295.      This  section defines the maximum amount of time (in minutes)  that  a
  3296.      user can remain online for each security level (SL) setting.
  3297.  
  3298.      Upon selecting this option, the following screen is displayed  (screen
  3299.      has been shortened for simplicity):
  3300.      ______________________________________________________________________
  3301.  
  3302.      Editing: Time limitations
  3303.  
  3304.      0:1     20:20   40:50    60:90    80:110  100:130  120:130  140:130
  3305.      1:1     21:20   41:50    61:90    81:110  101:130  121:130  141:130
  3306.        .       .       .        .        .        .        .         .
  3307.        .       .       .        .        .        .        .         .
  3308.        .       .       .        .        .        .        .         .
  3309.      19:10   39:40   59:80    79:100   99:120  119:130  139:130  159:130
  3310.  
  3311.      Range settings (S)et (T)oggle (Q)uit :
  3312.      ______________________________________________________________________
  3313.  
  3314.      The three commands available here are:
  3315.  
  3316.           (S)et - Sets the SL values for a range of SL settings.  You are
  3317.                asked to enter the starting and ending SL settings, and the
  3318.                new value to be placed in those settings.  Available SL
  3319.                settings are 0-255.
  3320.  
  3321.           (T)oggle - Switches the display between showing SL settings 0-159
  3322.                and 160-255.  Note that this does not affect the setting of
  3323.                SL values; the (S)et command can change values anywhere in
  3324.                the 0-255 SL range without necessarily having them currently
  3325.                displayed on the screen.
  3326.  
  3327.           (Q)uit - Returns you to the System Configuration menu.
  3328.  
  3329.  
  3330.  
  3331.  
  3332.  
  3333.  
  3334.  
  3335.  
  3336.  
  3337.  
  3338.  
  3339.  
  3340.  
  3341.  
  3342.  
  3343.  
  3344.  
  3345.  
  3346.  
  3347.  
  3348.  
  3349.                                    - Page 51 -
  3350.  
  3351.                    PegaSys Main Documentation - Version 0.43
  3352.  
  3353.  
  3354.      -----------------------
  3355.      CALL ALLOWANCES PER DAY
  3356.      -----------------------
  3357.  
  3358.      This  section  works  off  the  exact  same  principle  as  the   Time
  3359.      Limitations   section,  therefore  the  above  example  should   prove
  3360.      sufficient.   This  section sets the number of calls  allowed  in  any
  3361.      given day for a particular security level (SL).
  3362.  
  3363.  
  3364.      ---------------------------
  3365.      UL/DL NUMBER OF FILES RATIO
  3366.      ---------------------------
  3367.  
  3368.      This  section  works  off  the  exact  same  principle  as  the   Time
  3369.      Limitations   section,  therefore  the  above  example  should   prove
  3370.      sufficient.   This  section sets the number of files that a  user  can
  3371.      download  for every ONE file that the user uploads, for  a  particular
  3372.      security level (SL).
  3373.  
  3374.  
  3375.      ---------------------
  3376.      UL/DL KILOBYTES RATIO
  3377.      ---------------------
  3378.  
  3379.      This  section  works  off  the  exact  same  principle  as  the   Time
  3380.      Limitations   section,  therefore  the  above  example  should   prove
  3381.      sufficient.  This section sets the number of kilobytes that a user can
  3382.      download  for  every  ONE  KILOBYTE  that  the  user  uploads,  for  a
  3383.      particular security level (SL).
  3384.  
  3385.  
  3386.  
  3387.  
  3388.  
  3389.  
  3390.  
  3391.  
  3392.  
  3393.  
  3394.  
  3395.  
  3396.  
  3397.  
  3398.  
  3399.  
  3400.  
  3401.  
  3402.  
  3403.  
  3404.  
  3405.  
  3406.  
  3407.  
  3408.  
  3409.  
  3410.  
  3411.  
  3412.                                    - Page 52 -
  3413.  
  3414.                    PegaSys Main Documentation - Version 0.43
  3415.  
  3416.  
  3417.                               ___________________
  3418.  
  3419.                                MODEM INFORMATION
  3420.                               ___________________
  3421.  
  3422.  
  3423.      PegaSys   can operate with a wide variety of modems... which is  good,
  3424.      considering  the wide variety of modems out there!  Therein,  however,
  3425.      lies  the  problem... since modems vary so widely,  one  configuration
  3426.      cannot  hope  to  work with all modems.   Hopefully,  the  information
  3427.      presented  here  will  help you get your modem  up  and  running  with
  3428.      PegaSys .   Also  presented is information on using  PegaSys   with  a
  3429.      FOSSIL communications driver.
  3430.  
  3431.  
  3432.      -----------------------------
  3433.      SAMPLE INITIALIZATION STRINGS
  3434.      -----------------------------
  3435.  
  3436.      Shown  below  are some sample initialization strings.  If  your  modem
  3437.      does not respond to the default string, try using one of these.
  3438.  
  3439.           Tested and verified using the Everex Evercom EX-920 and the
  3440.           Avatex 1200 1200 baud modems:
  3441.  
  3442.                "ATH0Q0V0E0M1X1S0=0S2=1S10=45"
  3443.  
  3444.           Tested and verified using the Avatex 2400 and the Tektoniks 2400
  3445.           2400 baud modems:
  3446.  
  3447.                "ATH0Q0V0E0M1S0=0S2=1S7=45S9=3"
  3448.  
  3449.           Tested and verified using the Cardinal Technologies MB2450 2400
  3450.           baud modem:
  3451.  
  3452.                "ATH0Q0V0E0M0X1S0=0S2=1S7=45S10=40&C1&D2"
  3453.  
  3454.           Tested (but not fully) with Tandy Hayes-compatible modems:
  3455.  
  3456.                "ATH0Q0V0E0M0X1S2=1S10=40"
  3457.  
  3458.      Note  that  just because the description states that it works  with  a
  3459.      certain  brand  at a certain speed, it doesn't mean that it  will  not
  3460.      work with YOUR modem.  The only way to be sure is to try.
  3461.  
  3462.  
  3463.      -----------------
  3464.      HIGH-SPEED MODEMS
  3465.      -----------------
  3466.  
  3467.      In the world of the IBM PC, modems that run at 300, 1200 and 2400 baud
  3468.      are pretty standard; they use the same data transmission formats,  and
  3469.      they are -- for the most part -- compatible with the Hayes SmartModem.
  3470.  
  3471.      The  world  of 9600 baud (and higher) modems is  a  different  matter.
  3472.      Several  different  data transmission standards exist -- the  HST  and
  3473.  
  3474.  
  3475.                                    - Page 53 -
  3476.  
  3477.                    PegaSys Main Documentation - Version 0.43
  3478.  
  3479.  
  3480.      V.32 standards are the most common -- as well as different  variations
  3481.      on the Hayes command set.  Other features, such as baud locking,  make
  3482.      using  a  high-speed  modem on BBS systems a  formidable  task.   This
  3483.      chapter is devoted to "clearing the air" about such matters.
  3484.  
  3485.      Current information is sparse, as high-speed modems are relatively new
  3486.      to  the market (and just coming into the price range of most  computer
  3487.      users).  When we receive more information about high-speed modems,  we
  3488.      will be updating our information and informing you, the user, as  soon
  3489.      as we have all the facts.
  3490.  
  3491.      Note  that  we DO NOT GUARANTEE that this information will  work  with
  3492.      your  modem!  We are providing it to serve as a starting point; if  it
  3493.      works  perfect  with your high-speed modem, all the  better.   If  you
  3494.      absolutely  cannot  get your high-speed modem to work  with  PegaSys ,
  3495.      contact one of the Alpha or Beta sites near you for assistance.
  3496.  
  3497.  
  3498.      THE US ROBOTICS DUAL STANDARD MODEM
  3499.  
  3500.      Below  is  the  configuration information for  the  US  Robotics  Dual
  3501.      Standard  modem  (set  up in the Modem Configuration  section  of  the
  3502.      system  configuration),  allowing baud locking at 19,200  baud.   This
  3503.      setup  should also work -- with a little modification -- with  the  US
  3504.      Robotics HST 9600 modem (though it hasn't been tested).
  3505.  
  3506.      1. Maximum baud rate    : 38400
  3507.      2. COM port number      : 1
  3508.      3. Modem initialization string:
  3509.         "ATB0E0H0M0V0X6&A1&B2&D0&H3&I5&K1&M4&N0&R2|"
  3510.      4. Modem answer string  : "ATA"
  3511.      5. Modem hangup string  : "~~~+++~~~ATH0"
  3512.      6. Modem offhook string : "ATH1M0"
  3513.      7. No-call init time    : 15
  3514.      A. 9600 ARQ rate baud   : 38400 baud
  3515.      F. Comm flags: CTS check ON, DSR check ON, XON/XOFF OFF, Normal
  3516.      carrier
  3517.      $. Force baud rates?    : Yes
  3518.      R. Modem result codes:
  3519.                           Case 1   Case 2 (ARQ)
  3520.          R1. NO CARRIER : 3
  3521.          R2. NO DIALTONE: 6
  3522.          R3. BUSY       : 7
  3523.          R4.  300 BAUD  : 4        14
  3524.          R5. 1200 BAUD  : 5        15
  3525.          R6. 2400 BAUD  : 10       16
  3526.          R7. 4800 BAUD  : 18       19
  3527.          R8. 9600 BAUD  : 13       17
  3528.  
  3529.  
  3530.      ------------------------------------
  3531.      USING A FOSSIL COMMUNICATIONS DRIVER
  3532.      ------------------------------------
  3533.  
  3534.      FOSSIL  stands  for Fido/Opus/SEAdog Standard Interface  Layer,  which
  3535.      specifies  a  generic  telecommunication  interface  for  IBM  PC  and
  3536.  
  3537.  
  3538.                                    - Page 54 -
  3539.  
  3540.                    PegaSys Main Documentation - Version 0.43
  3541.  
  3542.  
  3543.      compatible  -- and less-than-compatible -- systems.  Due to  the  fact
  3544.      that it is a standard specification, the FOSSIL driver has gained wide
  3545.      acceptance  in the FidoNet community, and is used in various  FidoNet-
  3546.      related products.  It allows systems that are similar to the IBM PC --
  3547.      but with wide-ranging architecture -- to use the same software without
  3548.      modification.
  3549.  
  3550.  
  3551.      THE HISTORY OF FOSSIL
  3552.  
  3553.      To  better  explain  the history of FOSSIL, here is  an  excerpt  from
  3554.      "Fundamentals  of FOSSIL Implementation and Use, Version 5",  by  Rick
  3555.      Moore:
  3556.  
  3557.      "For  those  people who were not lucky enough to have an IBM PC  or  a
  3558.      system  nearly  completely  compatible, the world has  not  been  very
  3559.      friendly.  With his implementation of the Generic Fido(tm) driver, Tom
  3560.      Jennings made it possible for systems that had nothing in common  with
  3561.      an  IBM PC except an 808x-class processor, and the ability to run  MS-
  3562.      DOS Version 2 and above, to run his Fido(tm) software.  That was a lot
  3563.      to ask, and a lot of people though it was enough.
  3564.  
  3565.      "But not everyone.  While Thom Henderson was debugging version 4.0  of
  3566.      his SEAdog(tm) mail package, an 'extended' Generic driver was designed
  3567.      (in  cooperation with Bob Hartman) as a quick kludge to help  him  get
  3568.      past  a  problem with certain UART chips.  The new  hook  was  quickly
  3569.      pounced  upon  by  Vince Perriello, who, with  almost  DAILY  prodding
  3570.      (ouch! it still hurts) by Ken Kaplan, had been working with  Henderson
  3571.      to get DEC Rainbow support into SEAdog.  Vince then coded a driver  to
  3572.      use  this hook and - Voila! - SEAdog 4.0 started working like a  champ
  3573.      on the Rainbow.
  3574.  
  3575.      "At  the same time something was rotten in the state of  Texas.   Wynn
  3576.      Wagner  started  encountering some serious difficulties  in  his  Opus
  3577.      development effort.  Specifically, he couldn't force the Greenleaf(tm)
  3578.      Communications  Libraries  to behave in exactly the way he  felt  Opus
  3579.      required.   Enter Bob Hartman.  Having already enjoyed success in  the
  3580.      effort  with Thom Henderson, he suggested to Wynn that with  very  few
  3581.      extensions,  any  driver that was already  SEAdog(tm)  4.0  compatible
  3582.      could  drive  Opus  as well.  About that time, Vince  called  Wynn  to
  3583.      discuss porting Opus to the DEC Rainbow.  Wynn called Bob, Bob  called
  3584.      Vince, and the FOSSIL driver came into existence.
  3585.  
  3586.      "To  say  that the concept has gained wide acceptance in  the  FidoNet
  3587.      community  would be an understatement.  Henk Weavers' DUTCHIE  package
  3588.      uses  the  FOSSIL communications services.  Ron Bemis'  OUTER  package
  3589.      uses  FOSSIL  services for everything it does and as a  result  it  is
  3590.      completely generic.  There are already FOSSIL implementations for  the
  3591.      Tandy   2000,  Heath/Zenith  100,  Sanyo  555  and   other   'non-IBM'
  3592.      architectures.   With each new 'port' of the spec, the potential of  a
  3593.      properly coded FOSSIL application grows!"
  3594.  
  3595.  
  3596.  
  3597.  
  3598.  
  3599.  
  3600.  
  3601.                                    - Page 55 -
  3602.  
  3603.                    PegaSys Main Documentation - Version 0.43
  3604.  
  3605.  
  3606.      HOW A FOSSIL DRIVER BENEFITS PEGASYS
  3607.  
  3608.      Using a FOSSIL driver with PegaSys  has several advantages.  First and
  3609.      foremost, PegaSys  can now be used with IBM PC-type systems that don't
  3610.      use  the  exact  same communications  standard.   Also,  since  FOSSIL
  3611.      drivers are time-proven, reliable, and -- best of all -- FAST,  system
  3612.      performance is increased.  Most FOSSIL drivers will also work reliably
  3613.      with  COM  ports  3,  4, and higher.   Finally,  FOSSIL  drivers  work
  3614.      splendidly with high-speed modems.  Thus, if you can't get your  high-
  3615.      speed  modem to work reliably with PegaSys 's  built-in  communication
  3616.      routines and/or with COM port 3 or higher, try using a FOSSIL driver.
  3617.  
  3618.      PegaSys   will take care of enabling and disabling the  FOSSIL  driver
  3619.      when  needed; it will not be left "hanging" when you shell to DOS  (to
  3620.      execute a door, etc.) or exit the BBS.  It is completely reliable.
  3621.  
  3622.  
  3623.      INSTALLING A FOSSIL DRIVER WITH PEGASYS
  3624.  
  3625.      Below  are the steps necessary to use PegaSys  with a  FOSSIL  driver.
  3626.      If  one  FOSSIL driver doesn't work to your  satisfaction,  try  using
  3627.      another; there are plenty of them out there.  If you have any  trouble
  3628.      getting  a  FOSSIL driver to work with PegaSys , contact  one  of  the
  3629.      Alpha or Beta sites near you.
  3630.  
  3631.           1.   Get a FOSSIL driver.  If you own a true IBM compatible,
  3632.                there are several drivers to choose from:  X00.SYS,
  3633.                Opus!Comm, and BNUcom are just three of them.  (For the
  3634.                following examples, X00.SYS is assumed.)
  3635.  
  3636.           2.   Install the FOSSIL driver into your AUTOEXEC.BAT (if it is a
  3637.                COM or EXE program) or CONFIG.SYS (if it is a SYS driver)
  3638.                file.  Make sure it is set up to work with ONE
  3639.                communications port.  (For example, installing X00.SYS would
  3640.                use "DEVICE=X00.SYS E 1" in your CONFIG.SYS file.)
  3641.  
  3642.                It is a good idea to use a small transmit buffer (if your
  3643.                FOSSIL driver supports it), say around 1024 bytes or less.
  3644.                If a larger buffer is used, it will fill up too fast, and
  3645.                users will not be able to abort displays very easily.  (If
  3646.                you are using a high-speed modem, you may actually WANT to
  3647.                use a larger buffer for better performance.  You'll have to
  3648.                experiment with it.)
  3649.  
  3650.           3.   Reboot your system so the FOSSIL driver will be installed.
  3651.  
  3652.           4.   Start up the BBS, go into the system configuration, and
  3653.                enter the General Flagged Functions section.  Toggle option
  3654.                "B" ("Use FOSSIL comm. driver") to YES.  This will tell
  3655.                PegaSys  to use the FOSSIL driver instead of the built-in
  3656.                communications routines.
  3657.  
  3658.                Don't worry about messing things up if you enable this
  3659.                option without a FOSSIL driver installed; PegaSys  is smart
  3660.                enough to recognize whether or not a FOSSIL driver actually
  3661.                exists, and to use the built-in routines if it doesn't.
  3662.  
  3663.  
  3664.                                    - Page 56 -
  3665.  
  3666.                    PegaSys Main Documentation - Version 0.43
  3667.  
  3668.  
  3669.                                _________________
  3670.  
  3671.                                 THE USER EDITOR
  3672.                                _________________
  3673.  
  3674.  
  3675.      PegaSys 's  user editor is a feature you will use in conjunction  with
  3676.      others  to determine who has access to various parts of  your  system.
  3677.      In addition, all sorts of information about each user is kept here for
  3678.      you.
  3679.  
  3680.      Upon  entry  to  the user editor, you will see  the  following  screen
  3681.      (which has been compressed slightly to fit on the page):
  3682.      ______________________________________________________________________
  3683.  
  3684.      User #1 of 1     Status:None            SL:255   DSL:255
  3685.      User name:SysOp                         AR:ABCDEFGHIJKLMNOPQRSTUVWXYZ
  3686.      Real name:System Operator               AC:----------/1234
  3687.      Address      :Unknown                   Sex/Age :M00 (00/00/00)
  3688.      City / State :Unknown, MI               Zip-code:00000
  3689.      Computer Type:IBM PC                    Phone # :000-000-0000
  3690.      SysOp note   :                          Last/1st:01/01/80 (01/01/80)
  3691.      Occupation   :SysOp                     Lockfile:inactive
  3692.      BBS reference:                          Password:SYSOP
  3693.      Call records- TC:1        TT:1          CT:0    TL:32761    Tbank:0
  3694.      Mail records- Pub:0       Priv:0        Fback:0     Wait:0
  3695.      File records- DL:0        UL:0-0k             Pts:0
  3696.  
  3697.      Option :
  3698.      ______________________________________________________________________
  3699.  
  3700.      Each command available in the user editor is detailed below.
  3701.  
  3702.           ;    Toggles between "long" and "short" display modes.  The long
  3703.                mode is shown above.  The short mode displays only the user
  3704.                record number, user status, SL and DSL, user name, real
  3705.                name, AR flags, and AC flags.
  3706.  
  3707.           :    Used to "turn off" the display of the user account records.
  3708.                This speeds things up considerably when you already know
  3709.                what you intend to do next.  However, [ENTER] will still
  3710.                redisplay the account if needed.
  3711.  
  3712.           [    Allows editing of the record previous to the current one.
  3713.                If you are at the first record, this command will move to
  3714.                the last record.
  3715.  
  3716.           ]    Allows editing of the record after the current one.  If you
  3717.                are at the last record, this command will move to the first
  3718.                record.
  3719.  
  3720.           =    This command restores the original information for the
  3721.                current record, IF you have not moved to another record or
  3722.                exited the user editor.  In effect, the information in the
  3723.                current record is not recorded UNTIL you move to another
  3724.                record or exit the user editor.  (Think of "=" as an "undo"
  3725.  
  3726.  
  3727.                                    - Page 57 -
  3728.  
  3729.                    PegaSys Main Documentation - Version 0.43
  3730.  
  3731.  
  3732.                or "oops!" feature.)
  3733.  
  3734.           {    Searches backwards in the user file for all users matching
  3735.                the criteria declared in "O" (search options).  If at the
  3736.                lowest matching user, the highest matching user will be
  3737.                displayed.  If no criteria has been declared, this command
  3738.                acts the same as "[".
  3739.  
  3740.           }    Searches forward in the user file for all users matching the
  3741.                criteria declared in "O" (search options).  If at the
  3742.                highest matching user, the lowest matching user will be
  3743.                displayed.  If no criteria has been declared, this command
  3744.                acts the same as "]".
  3745.  
  3746.           *    Automatically validates a new user with the SL, DSL, AR
  3747.                flags, and restrictions as defined in the system
  3748.                configuration.
  3749.  
  3750.           ~    This command will trap (record) EVERY single action of a
  3751.                user from logon to logoff, including file scans, message
  3752.                scans, posts, etc.  It is far more comprehensive than the
  3753.                SYSOP.LOG file (explained later) and is used to record the
  3754.                actions of "problem users" or to reconstruct events if
  3755.                there has been some type of a common crash occurring with
  3756.                numerous callers.
  3757.  
  3758.                When this is toggled to ON, it will prompt for whether or
  3759.                not to trap, and whether or not to send it to a separate
  3760.                file.  If it is sent to a separate file, the status bar in
  3761.                the user record will say "Trapping (Separate)", and the
  3762.                trapping will be sent to a file called TRAPxxxx.MSG with the
  3763.                "xxxx" corresponding to the user's record number.  If the
  3764.                trapping is NOT separate, then it will go to a common file
  3765.                called TRAP.MSG.
  3766.  
  3767.           @    This option allows a user to be "locked out" from the BBS;
  3768.                the user will not be allowed to log back on under that name
  3769.                or handle.  You will be prompted for a lockout filename,
  3770.                which can contain your own personal message to that special
  3771.                someone you would like to repay for all his/her kindness.
  3772.                If a filename is entered, that text is displayed each time
  3773.                the user tries to call.  If no special file is chosen, it
  3774.                displays a common one called LOCKOUT.MSG and then hangs up.
  3775.  
  3776.           !    Toggles the "alert" status of the user.  If on, an "ALERT!"
  3777.                message is displayed in the SysOp window and a siren will
  3778.                sound (until you press [F9] to shut it off).
  3779.  
  3780.           A    Alters the user's address.
  3781.  
  3782.           C    Alters the user's city and state/province.
  3783.  
  3784.           D    Alters the user's download security level (DSL).
  3785.  
  3786.           E    Allows toggling of the user's AC flags.  The various flags
  3787.                are explained in detail in the system configuration section
  3788.  
  3789.  
  3790.                                    - Page 58 -
  3791.  
  3792.                    PegaSys Main Documentation - Version 0.43
  3793.  
  3794.  
  3795.                (under "New User and Auto-Validation Settings").
  3796.  
  3797.           F    Allows toggling of the user's AR flags, which can allow (or
  3798.                restrict) access to various sections of the BBS.  These
  3799.                flags are not defined with a specific purpose; their use is
  3800.                entirely controlled by you.
  3801.  
  3802.           G    Alters the user's date of birth.
  3803.  
  3804.           I    Alters the user's "occupation" comment.
  3805.  
  3806.           K    Alters the comment field.  This field can be used as a
  3807.                "scratch pad" for keeping notes on the user.
  3808.  
  3809.           L    Alters the date that the user last called the BBS.
  3810.  
  3811.           M    Alters the status of the user's mailbox.  If the mailbox is
  3812.                closed, no Email can be sent to that particular user.  (The
  3813.                only exception is the user that is designated to receive
  3814.                validation letters from new users.  New user validation
  3815.                letters will be "forced" into the mailbox, even if it is
  3816.                closed).  If the mailbox is open, the option exists to route
  3817.                the mail to another user.
  3818.  
  3819.           N    Alters the user's name.  If the BBS allows handles, this
  3820.                name can be different from the user's real name.
  3821.  
  3822.           O    Specifies certain criteria for searching for users.  The
  3823.                following criteria are defined:
  3824.  
  3825.                     General text
  3826.                     ACS
  3827.                     SL
  3828.                     DSL
  3829.                     AR flags
  3830.                     AC flags
  3831.                     Status (alert, chat buffering, deleted, locked out,
  3832.                          separate SysOp log, trapping)
  3833.                     Days since last on
  3834.                     Days since first on
  3835.                     Number of calls
  3836.                     User age
  3837.                     User gender
  3838.                     # 1/10's call/post
  3839.                     #k DL/1k UL
  3840.                     # DLs/1 UL
  3841.  
  3842.                In addition, there are several commands that can be used
  3843.                while in this sub-menu:
  3844.  
  3845.                     (L)ist options - List the current definitions for
  3846.                          each option.
  3847.  
  3848.                     (T)oggle options on/off - Toggle an option on/off.
  3849.  
  3850.                     (C)lear options - Make all options inactive.
  3851.  
  3852.  
  3853.                                    - Page 59 -
  3854.  
  3855.                    PegaSys Main Documentation - Version 0.43
  3856.  
  3857.  
  3858.                     (U)sers who match - List all users who match the
  3859.                          defined criteria.
  3860.  
  3861.                     (Q)uit - Return to the user editor.
  3862.  
  3863.           P    Alters the user's telephone number.
  3864.  
  3865.           R    Alters the user's real name.
  3866.  
  3867.           S    Alters the user's security level (SL).
  3868.  
  3869.           T    Alters the user's computer type.
  3870.  
  3871.           U    Moves directly to another user's record.  You may enter the
  3872.                user number, the user name, or a partial search string (the
  3873.                user file will be searched for every user name that contains
  3874.                the search string, and you will be prompted one by one).
  3875.  
  3876.           W    Alters the "heard about this BBS from?" comment field.
  3877.  
  3878.           Y    Assigns the user as a message base SysOp for up to five
  3879.                message bases.  Remember to alter this if you delete and/or
  3880.                move message bases via the message base editor!
  3881.  
  3882.           Z    Alters the user's postal zip code.
  3883.  
  3884.           $    Alters the user's password.
  3885.  
  3886.           \    Allows viewing of the separate SysOp log for this user (if
  3887.                one has been set up).
  3888.  
  3889.           1    Allows alteration of the user's calling records, both daily
  3890.                and cumulative values.  The total calls, total time on,
  3891.                calls today, time left today, and illegal logon attempts
  3892.                fields can be changed.
  3893.  
  3894.           2    Allows alteration of the user's cumulative mail records.
  3895.                The total public posts, total private posts (Email), total
  3896.                feedback sent, and mail waiting fields can be changed.
  3897.  
  3898.           3    Allows alteration of the user's cumulative UL/DL records.
  3899.                The number of uploaded files, number of downloaded files,
  3900.                total upload kilobyte value, and total download kilobyte
  3901.                value fields can be changed.
  3902.  
  3903.           '    Alters the user's personal color setup.  Both color and
  3904.                black-and-white setups can be changed.
  3905.  
  3906.           #    Alters the user's file points.
  3907.  
  3908.           &    Alters the amount of time in minutes that the user has in
  3909.                the Time Bank.  The maximum amount of time allowed is 600
  3910.                minutes total.
  3911.  
  3912.           ^    Toggles deletion of a user's record.  In the event a user is
  3913.                deleted, all voting records and Email (both to and from the
  3914.  
  3915.  
  3916.                                    - Page 60 -
  3917.  
  3918.                    PegaSys Main Documentation - Version 0.43
  3919.  
  3920.  
  3921.                user) are deleted.
  3922.  
  3923.           -    Allows viewing of the user's answers to the NEWUSER.INF
  3924.                InfoForm questionnaire (stored in NEWUSER.ASW), if one was
  3925.                used.
  3926.  
  3927.           _    Allows viewing of the user's answers to any InfoForm
  3928.                questionnaire.  You will be prompted to enter the filename
  3929.                of the InfoForm questionnaire; the answers will be extracted
  3930.                from the corresponding *.ASW file.
  3931.  
  3932.           Q    Exits the user editor and returns to the WFC menu (or the
  3933.                BBS if online).
  3934.  
  3935.  
  3936.  
  3937.  
  3938.  
  3939.  
  3940.  
  3941.  
  3942.  
  3943.  
  3944.  
  3945.  
  3946.  
  3947.  
  3948.  
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.  
  3957.  
  3958.  
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.  
  3965.  
  3966.  
  3967.  
  3968.  
  3969.  
  3970.  
  3971.  
  3972.  
  3973.  
  3974.  
  3975.  
  3976.  
  3977.  
  3978.  
  3979.                                    - Page 61 -
  3980.  
  3981.                    PegaSys Main Documentation - Version 0.43
  3982.  
  3983.  
  3984.                              ______________________
  3985.  
  3986.                               THE FILE BASE EDITOR
  3987.                              ______________________
  3988.  
  3989.  
  3990.      The file base editor serves a valuable purpose in that it sets up your
  3991.      file  bases, which are ESSENTIAL for the uploading and downloading  of
  3992.      files on the BBS.
  3993.  
  3994.      Upon  entering the file base editor, a screen similar to  the  example
  3995.      shown below will be displayed (it has been compressed slightly to  fit
  3996.      on the page):
  3997.      ______________________________________________________________________
  3998.  
  3999.      NNN:File base name           :Flags:ACS     :UL ACS:Name ACS:Maxf:Dep
  4000.      ===:=========================:=====:========:======:========:====:===
  4001.      0   SysOp                     ----- s200d200 U1              100  0
  4002.      1   General                   ---N- d50             s50      50   0
  4003.      2   IBM Games                 ----- d50fG                    200  0
  4004.      3   Communications Programs   ----- d60                      50   0
  4005.      4   GIF Pictures [VGA ONLY]   -G--- d60                      500  0
  4006.      ______________________________________________________________________
  4007.  
  4008.      The following commands are available from this screen:
  4009.  
  4010.           <CR>Redisplay screen
  4011.           (D)elete base (I)nsert base
  4012.           (M)odify base (P)osition base
  4013.           (Q)uit        (T)oggle display format
  4014.  
  4015.      and are explained in detail below.
  4016.  
  4017.           <CR>Redisplay screen -- It will redisplay the listing of file
  4018.                bases when pressed.
  4019.  
  4020.           (D)elete -- Used to remove a file base.  You will be prompted
  4021.                WHICH base you want to delete.  File bases number from 0 to
  4022.                the highest; PegaSys  currently has provisions for 97 file
  4023.                bases.  When you delete a file board, it will move all
  4024.                following file bases up one in position.  Also, the filename
  4025.                that described the files present in the directory is erased
  4026.                (you are prompted with "Delete it (Y/N)?", just in case you
  4027.                wish to abort the deletion.
  4028.  
  4029.           (I)nsert -- Used to insert another file board in your file
  4030.                system.  It will prompt you with "File base to insert before
  4031.                (0-xx)?", with "xx" being the highest base currently.  Also,
  4032.                PegaSys  has a maximum of 97 file bases ranging from (0-96).
  4033.                Inserting a file board will move all subsequent boards up
  4034.                one in position.
  4035.  
  4036.                NOTE: PegaSys  uses "<<Not Used>>" as the default
  4037.                description, NEWDIR as the default filename, and "C:DLOADS\"
  4038.                as the default file path when you insert a board.
  4039.  
  4040.  
  4041.  
  4042.                                    - Page 62 -
  4043.  
  4044.                    PegaSys Main Documentation - Version 0.43
  4045.  
  4046.  
  4047.           (M)odify -- Allows changes to be made to the security setting of
  4048.                the file base, the file path, the board name, maximum number
  4049.                of files, and the filename, which stores the data of the
  4050.                file descriptions of that particular file board.  Details of
  4051.                this command are presented later.
  4052.  
  4053.           (P)osition -- Moves the file boards around in position.  For
  4054.                example, if you recently created a file base 0, and wished
  4055.                for it to be after file board 2, then you would change the
  4056.                position from 0 to 3.
  4057.  
  4058.           (T)oggle -- Toggles the file board editor between three display
  4059.                modes.  The common and default one is illustrated at the
  4060.                beginning of the file editor discussion.
  4061.  
  4062.           (Q)uit -- Exits the file base editor.
  4063.  
  4064.      Now, for an explanation of how to modify individual file bases.   When
  4065.      you select the (M)odify command, you will be asked which base you wish
  4066.      to modify.  After you make your selection, you will be shown a  screen
  4067.      similar to the following example:
  4068.      ______________________________________________________________________
  4069.  
  4070.      1. Name        : General Files
  4071.      2. Filename    : GENERAL
  4072.      3. DL/UL path  : C:\BBS\DLOADS\GENERAL\  /Same
  4073.      4. ACS required: "s50d50fG"
  4074.      5. UL/Name ACS : "" / ""
  4075.      6. Max files   : 50
  4076.      7. Password    : ""
  4077.      8. Arc/cmt type: ZIP/1
  4078.      9. Dir depth   : 0
  4079.         Flags       : -----
  4080.         P-Index     : 27
  4081.      Q. Quit
  4082.  
  4083.      Enter selection (1-9) [Q]uit :
  4084.      ______________________________________________________________________
  4085.  
  4086.      The commands available from this screen are:
  4087.  
  4088.           <CR>Redisplay screen
  4089.           1-8:Modify item
  4090.           ([)Back entry        (])Forward entry
  4091.           (J)ump to entry      (F)irst entry in list
  4092.           (Q)uit and save      (L)ast entry in list
  4093.  
  4094.           Toggles:
  4095.           (N)oRatio            (U)nhidden
  4096.           (D)ir-header         (I)*.DIR file in DLPATH
  4097.           (G)ifSpecs
  4098.  
  4099.      and are explained in detail below.
  4100.  
  4101.           1    Allows you to rename the current file base.  It stores the
  4102.                name as ASCII text, with a maximum of 40 characters (less if
  4103.  
  4104.  
  4105.                                    - Page 63 -
  4106.  
  4107.                    PegaSys Main Documentation - Version 0.43
  4108.  
  4109.  
  4110.                MCI colors are used, which take up 2 characters each).
  4111.  
  4112.           2    Allows you to alter the directory filename, which stores the
  4113.                information on each file in the file base (description, file
  4114.                points, date uploaded, length, etc.).  The respective files
  4115.                are stored in the GFILES path as ".DIR" files (or in the
  4116.                upload path if the "(I)*.DIR file in DLPATH" flag is set).
  4117.  
  4118.           3    Allows you to reconfigure the path to which your files are
  4119.                stored in.  The default is "C:DLOADS\", but PegaSys  will
  4120.                accept any logical drive that DOS supports, if present.  If
  4121.                the DL and UL paths are the same, "Same" is displayed for
  4122.                the UL path.  The option of separate paths is provided to
  4123.                aid the SysOp if, for example, the SysOp has one directory
  4124.                for all new files; until validation, they can be sent there.
  4125.  
  4126.           4    This is a security feature of the file system, designed for
  4127.                different security levels, with primary emphasis on HIGHER
  4128.                security levels.  The user must be able to satisfy the
  4129.                specified Access Condition String in order to have access to
  4130.                that file base.
  4131.  
  4132.           5    A user must be able to satisfy the specified ACS in order to
  4133.                be allowed to upload files to that particular directory.
  4134.                The name ACS is used as a secondary security option so that
  4135.                only persons satisfying the name ACS will be able to see the
  4136.                uploader's name in the secondary list option.  Also, it will
  4137.                not list the uploader's name when the user attempts to
  4138.                download a file from that particular file base, if the user
  4139.                does not satisfy the ACS requirements.
  4140.  
  4141.           6    This is the maximum number of files allowable in a file
  4142.                board.  If a user tries to upload a file when the maximum
  4143.                number of files is achieved, it will NOT allow the transfer.
  4144.                This value usually starts at 50 and may increase to 32,767
  4145.                files, depending on the need, and it relates to the number
  4146.                of individual files in the base and the number of individual
  4147.                descriptions in the filename.
  4148.  
  4149.           7    Another security feature, in that the user must enter a
  4150.                password each time they attempt to access the file board.
  4151.                Passwords may be 10 characters in length, and are
  4152.                alphanumeric in nature.  (The default password is "" [null],
  4153.                or no password.)
  4154.  
  4155.           8    This enables file bases to be set up with different
  4156.                compression types, as defined in the system configuration
  4157.                (the "Archive Configuration" sub-menu of the "File
  4158.                "Configuration" section).  You may have a few different
  4159.                file comments floating around, such as "Call [BBS]" or "From
  4160.                Another Fine PegaSys  Near You!".  (The default is the ZIP
  4161.                compression method and the first comment.)
  4162.  
  4163.           9    The directory depth feature has not been implemented (it is
  4164.                for future expansion).
  4165.  
  4166.  
  4167.  
  4168.                                    - Page 64 -
  4169.  
  4170.                    PegaSys Main Documentation - Version 0.43
  4171.  
  4172.  
  4173.           [    Displays the previous file base.  If at the first file base,
  4174.                this command has no effect.
  4175.  
  4176.           ]    Displays the next file base.  If at the last file base, this
  4177.                command has no effect.
  4178.  
  4179.           F    Displays the first file base.
  4180.  
  4181.           J    Displays the specified file base.
  4182.  
  4183.           L    Displays the last file base.
  4184.  
  4185.           Q    Exits the file base editor and returns to the WFC menu (or
  4186.                the BBS if online).
  4187.  
  4188.      The bottom two fields are defined as follows:
  4189.  
  4190.           Flags -- Five flags are present for toggling that regulate file
  4191.                viewing and ratios.  These flags are:
  4192.  
  4193.                     N - No ratio checking
  4194.                     U - File base is unhidden
  4195.                     D - [not implemented]
  4196.                     I - *.DIR file in DLPATH
  4197.                     G - Automatically insert GIFspecs on *.GIF files
  4198.  
  4199.                These flags are explained in more detail below.
  4200.  
  4201.           P-Index -- A "permanent index number" for the file base number
  4202.                that can NOT be changed.  It stays with the base from
  4203.                creation, regardless of insertions, deletions, and movements
  4204.                of file bases.
  4205.  
  4206.      The available flags are toggled with the following commands:
  4207.  
  4208.           N    Sets the file base in question so that there are no UL/DL
  4209.                ratio or file points checks.
  4210.  
  4211.           U    If toggled on, it will display a file base in an area
  4212.                listing regardless of whether or not the user has access to
  4213.                that base.  If the user lacks access, it will show in the
  4214.                list with a name but no base number and it will be
  4215.                inaccessible.
  4216.  
  4217.           D    This feature is not implemented (it is for future
  4218.                expansion).
  4219.  
  4220.           I    If toggled on, the *.DIR file for the particular file base
  4221.                will be stored in the download path instead of the GFILES
  4222.                directory.  An example of using this feature would be to
  4223.                store groups of files on floppy diskettes (with *.DIR files
  4224.                on each diskette).  That way, the disks can be "rotated"
  4225.                every once in a while (useful for GIF picture files, which
  4226.                can take up a LOT of space before you know it!).
  4227.  
  4228.  
  4229.  
  4230.  
  4231.                                    - Page 65 -
  4232.  
  4233.                    PegaSys Main Documentation - Version 0.43
  4234.  
  4235.  
  4236.           G    Speaking of GIF files... this flag is used for directories
  4237.                containing GIF pictures, and if toggled on, the BBS will,
  4238.                upon uploading, insert in the description the size and color
  4239.                information taken directly from the GIF file.  It is saved
  4240.                in the following format:
  4241.  
  4242.                     (xpixels,ypixels,colors)
  4243.  
  4244.                where "xpixels" is the width of the picture (the X axis),
  4245.                "ypixels" is the height of the picture (the Y axis), and
  4246.                "colors" is the number of colors used in display.
  4247.  
  4248.  
  4249.  
  4250.  
  4251.  
  4252.  
  4253.  
  4254.  
  4255.  
  4256.  
  4257.  
  4258.  
  4259.  
  4260.  
  4261.  
  4262.  
  4263.  
  4264.  
  4265.  
  4266.  
  4267.  
  4268.  
  4269.  
  4270.  
  4271.  
  4272.  
  4273.  
  4274.  
  4275.  
  4276.  
  4277.  
  4278.  
  4279.  
  4280.  
  4281.  
  4282.  
  4283.  
  4284.  
  4285.  
  4286.  
  4287.  
  4288.  
  4289.  
  4290.  
  4291.  
  4292.  
  4293.  
  4294.                                    - Page 66 -
  4295.  
  4296.                    PegaSys Main Documentation - Version 0.43
  4297.  
  4298.  
  4299.                            _________________________
  4300.  
  4301.                             THE MESSAGE BASE EDITOR
  4302.                            _________________________
  4303.  
  4304.  
  4305.      The message base editor is used to structure the message system in all
  4306.      features  such as data file name, maximum number of messages,  message
  4307.      base  security  levels  for viewing and posting,  and  other  security
  4308.      features.
  4309.  
  4310.      Upon  entry  to  the  message base editor, a  screen  similar  to  the
  4311.      examplebelow will appear (it has been compressed slightly to fit  onto
  4312.      the page):
  4313.      ______________________________________________________________________
  4314.  
  4315.      NNN Base name           :Flag:ACS       :Post ACS  :MCI ACS   :MaxM:An
  4316.      === ====================:====:==========:==========:==========:====:==
  4317.      1   General              L--- s10        s10        %          100  Y
  4318.      2   PegaSys  News!       L--- s10        s10        %          100  N
  4319.      3   Dear Abby            L--- s20        s20        %          50   A
  4320.      4   Star Trek Echo       ER-A s20        s20        %          500  N
  4321.      5   GroupMail Support    GR-A s20        s20        %          100  N
  4322.      ______________________________________________________________________
  4323.  
  4324.      The available commands from this screen are:
  4325.  
  4326.           <CR>Redisplay screen
  4327.           (D)elete base (I)nsert base
  4328.           (M)odify base (P)osition base
  4329.           (Q)uit        (T)oggle display format
  4330.  
  4331.      and are described as follows:
  4332.  
  4333.           <CR>Redisplay screen -- This will redisplay the list of message
  4334.                bases available for editing.
  4335.  
  4336.           (D)elete -- This command will delete a message base and move all
  4337.                the subsequent message bases up one entry.  If you try to
  4338.                delete a message base, as a warning it will display a string
  4339.                of ASCII text:  "[Base Name] Delete it?".
  4340.  
  4341.           (I)nsert -- Serves to insert a new message base and move all the
  4342.                subsequent bases down one in the listing.
  4343.  
  4344.           (M)odify -- Allows you to make modifications to the individual
  4345.                message bases that include things such as file names,
  4346.                security features, and the name of that message base.  This
  4347.                process is described in detail later.
  4348.  
  4349.           (P)osition -- Moves the message bases around in position.  For
  4350.                example, if you recently created a message base 0, and
  4351.                wished for it to be after message base 2, then you would use
  4352.                this command to change the position from 0 to 3.
  4353.  
  4354.  
  4355.  
  4356.  
  4357.                                    - Page 67 -
  4358.  
  4359.                    PegaSys Main Documentation - Version 0.43
  4360.  
  4361.  
  4362.           (T)oggle display format -- This will cause the message base
  4363.                editor to toggle between four different screens covering
  4364.                everything associated with the structure of a message base:
  4365.                Security, names, file paths, permanent index numbers, etc.
  4366.                The first and most common toggle mode is shown above.
  4367.  
  4368.           (Q)uit -- Exits the message base editor.
  4369.  
  4370.      When  you  select the (M)odify command, you are asked which  base  you
  4371.      wish  to modify.  After entering your selection, a screen  similar  to
  4372.      the following example is displayed:
  4373.      ______________________________________________________________________
  4374.  
  4375.      1. Name        : General
  4376.      2. Filename    : GENERAL
  4377.      3. Base type   : Local
  4378.         Message path: Unused  -OR-  <message directory path>
  4379.      4. ACS req.    : "s30"
  4380.      5. Post/MCI ACS: "s30" / "%"
  4381.      6. Max Mess    : 50
  4382.      7. Anonymous   : Yes
  4383.      8. Password    : ""
  4384.      C. Colors      : Unused  -OR-  Text=1, Quote=3, Tear=9, Origin=5
  4385.      M. Flags       : Unused  -OR-  KS-CB/MT
  4386.      O. Origin line : Unused  -OR-  "<origin line text>"
  4387.         Flags       : ---
  4388.         P-Index     : 0
  4389.      Q. Quit
  4390.      ______________________________________________________________________
  4391.  
  4392.      Each field and command is described in detail below.
  4393.  
  4394.           1    The name of the message base.  It is in straight ASCII text
  4395.                and has a maximum of 40 characters.  MCI colors and other
  4396.                commands may be used in the base name.
  4397.  
  4398.           2    The name of the message files.  Three files are created
  4399.                using this name:  "name.BRD" (the actual messages), "NAME.
  4400.                MIX" (index into the BRD file), and "name.TRE" (similar to
  4401.                MIX except for ReplyTree mode); the files are stored in the
  4402.                message directory defined in the system configuration.
  4403.  
  4404.           3    Designates the message base type.  Three types are currently
  4405.                available:
  4406.  
  4407.                     Local -- Allows the exchange of messages only between
  4408.                          the users of the BBS.
  4409.  
  4410.                     EchoMail -- Allows the exchange of messages, via the
  4411.                          FidoNet system, between users of BBSes linked
  4412.                          across the country and around the world.
  4413.  
  4414.                     GroupMail -- Similar in concept to EchoMail, but with
  4415.                          a different distribution method that, in many
  4416.                          cases, is faster and more reliable than EchoMail.
  4417.  
  4418.  
  4419.  
  4420.                                    - Page 68 -
  4421.  
  4422.                    PegaSys Main Documentation - Version 0.43
  4423.  
  4424.  
  4425.                When a base is defined as EchoMail or GroupMail, you will be
  4426.                prompted for the FidoNet message path.  This is required for
  4427.                PegaSys -specific FidoNet mail processing utilities; it is
  4428.                used to store temporary files.  For EchoMail messages, you
  4429.                can define the path off the message directory, using the
  4430.                same name as the message base filename.  (For example, if
  4431.                the base filename was "TREK", and the BBS message path was
  4432.                "C:\BBS\MSGS", you could define the directory path as
  4433.                "C:\BBS\MSGS\TREK".)
  4434.  
  4435.                For GroupMail messages, you'll have to use the paths created
  4436.                off the GROUP directory (as created by SEA's GROUP utility).
  4437.                For example, if the base filename was "BLATZ", and the
  4438.                GroupMail message path was "C:\BBS\GROUP", you must define
  4439.                the directory path as "C:\BBS\GROUP\BLATZ".  Consult the
  4440.                manual for the GROUP utility for more information, as well
  4441.                as the section "Using PegaSys  With FidoNet" in this manual.
  4442.  
  4443.                If a base is defined as Local, then "Unused" is shown as
  4444.                the message path in the "Message path:" field.  Otherwise,
  4445.                the actual directory pathname is shown.
  4446.  
  4447.           4    The ACS requirements that the user must meet in order to
  4448.                access the message base.  A caller that does not satisfy the
  4449.                requirements will notice a board is missing -- unless it is
  4450.                designated as "unhidden" -- but will have no clues as to
  4451.                what it is.  (If the "compress message/file bases" feature
  4452.                is enabled in the system configuration, then the user won't
  4453.                even know the base is missing!)
  4454.  
  4455.           5    For the post ACS, the user must satisfy the requirements in
  4456.                order to post messages on that base.  In some cases, users
  4457.                will be able to read messages, but be lacking in security to
  4458.                post.  For the MCI ACS, the user must satisfy the
  4459.                requirements in order to use MCI codes within messages.
  4460.  
  4461.                For non-local bases, it is recommended that you disable the
  4462.                MCI feature by specifying "%" for the ACS, as non-PegaSys
  4463.                systems will see the MCI codes (@1, @2, etc.) with no idea
  4464.                what they mean.
  4465.  
  4466.           6    This is the maximum number of messages that can be posted on
  4467.                the base.  The default is 50, with a maximum of 32767.  When
  4468.                the number of messages exceeds this limit, and the message
  4469.                bases are packed, old posts start getting removed (with the
  4470.                exception of messages that have been flagged "permanent").
  4471.  
  4472.           7    This determines the anonymity level of the message base.
  4473.                Available anonymity levels are:
  4474.  
  4475.                     (Y)es, anonymous allowed, selectively
  4476.                     (N)o, anonymous not allowed
  4477.                     (F)orced anonymous
  4478.                     (D)ear Abby
  4479.                     (A)ny Name
  4480.  
  4481.  
  4482.  
  4483.                                    - Page 69 -
  4484.  
  4485.                    PegaSys Main Documentation - Version 0.43
  4486.  
  4487.  
  4488.                and are defined as follows:
  4489.  
  4490.                     (Y)es, anonymous allowed, selectively -- Anonymous
  4491.                           posts are allowed on the board on an optional
  4492.                          basis.  After a user has posted a message, it will
  4493.                          prompt for "save", then it will feed another
  4494.                          prompt "Post anonymous?".  If the caller enters
  4495.                          "Y", the message will be anonymous and will be
  4496.                          unviewable EXCEPT to users that satisfy the ACS
  4497.                          for the "see anonymous public posts" setting in
  4498.                          in the system configuration.
  4499.  
  4500.                     (N)o, anonymous not allowed -- Anonymous posts are NO
  4501.                          allowed on that base by ANY user, no matter what
  4502.                          SL level they have.
  4503.  
  4504.                     (F)orced Anonymous -- This automatically makes every
  4505.                          post on the base anonymous, but can be viewed by
  4506.                          users under the conditions stated above for the
  4507.                          (Y)es setting.
  4508.  
  4509.                     (D)ear Abby -- This is for a "Dear Abby" problem
  4510.                          solving message base.  A user may post a message
  4511.                          under ANY one of these three possibilities:
  4512.  
  4513.                               "Problemed User" -- Posted by a user with
  4514.                                    personal problems, who wants help, but
  4515.                                    wishes to remain anonymous.
  4516.  
  4517.                               "Abby" -- Allows another user to respond to a
  4518.                                    problem post, with anonymity.
  4519.  
  4520.                               User name and number -- Allows a caller to
  4521.                                    post a problem/suggestion under THEIR
  4522.                                    handle and user number.
  4523.  
  4524.                     (A)ny Name -- Allows users to post messages using
  4525.                          either their own user name and number OR anything
  4526.                          they like.
  4527.  
  4528.                For non-local bases, it is recommended that the anonymous
  4529.                level be set to "NO", as anonymous messages are frowned upon
  4530.                on most EchoMail and GroupMail conferences (also, standard
  4531.                FidoNet message files can't support anonymous messages).
  4532.  
  4533.           8    A security feature that, if activated, will prompt the user
  4534.                for a password which must be entered correctly in order to
  4535.                access that message base.
  4536.  
  4537.           C    Defines the colors used for standard text, quoted text,
  4538.                tear, and origin lines when EchoMail and GroupMail messages
  4539.                are tossed into the message base.  Refer to the "FidoNet
  4540.                Configuration" section in "System Configuration" for more
  4541.                information.  NOTE:  This option cannot be selected if the
  4542.                base is defined as Local.
  4543.  
  4544.  
  4545.  
  4546.                                    - Page 70 -
  4547.  
  4548.                    PegaSys Main Documentation - Version 0.43
  4549.  
  4550.  
  4551.           M    Defines the various flag settings used when tossing,
  4552.                scanning, and posting EchoMail and GroupMail messages.  The
  4553.                currently available flags are:
  4554.  
  4555.                     K - Strip IFNA kludge lines.
  4556.                     S - Strip SEEN-BY lines (EchoMail only).
  4557.                     O - Strip origin lines.
  4558.                     C - Strip PegaSys  "center line" codes.
  4559.                     B - Strip PegaSys  "box line" codes.
  4560.                     M - Center boxed/centered lines with spaces.
  4561.                     T - Add tear and origin lines to posted messages.
  4562.  
  4563.                Refer to the "FidoNet Configuration" section in "System
  4564.                Configuration" for more information.  NOTE:  This option
  4565.                cannot be selected if the base is defined as Local.
  4566.  
  4567.           O    Defines the origin line placed at the bottom of EchoMail and
  4568.                GroupMail messages.  If an origin line is not defined here,
  4569.                the default origin line is used.  Refer to the "FidoNet
  4570.                Configuration" section in "System Configuration" for more
  4571.                information.  NOTE:  This option cannot be selected if the
  4572.                base is defined as Local.
  4573.  
  4574.           Q    Exits the message base editor.
  4575.  
  4576.      The last two fields are defined as follows:
  4577.  
  4578.           Flags -- Defined as follows:
  4579.  
  4580.                R - Real names only.
  4581.                U - Unhidden.
  4582.                A - Remove ANSI and 8-bit ASCII.
  4583.  
  4584.           P-Index -- The "permanent index" acts the same as the permanent
  4585.                index in the file system.  When a message base is created it
  4586.                is assigned the next highest index number and regardless of
  4587.                insertions, deletions, or movements of message boards, this
  4588.                number will stay the same.
  4589.  
  4590.      The flags are toggled with the following commands:
  4591.  
  4592.           R    If enabled, real names are stored in the "From:" and "To:"
  4593.                fields of each message, regardless of whether or not the
  4594.                BBS allows handles.  This is the preferred setting for Echo-
  4595.                Mail and GroupMail bases, as most conferences frown upon the
  4596.                use of handles (and some prohibit them outright).
  4597.  
  4598.           U    If enabled, it will display a message base in an area
  4599.                listing regardless of whether or not the user has access to
  4600.                that base.  If the user lacks access, it will show in the
  4601.                list with a name but no base number and it will be
  4602.                inaccessible.
  4603.  
  4604.           A    If enabled, ANSI codes and 8-bit ASCII characters (127-255)
  4605.                are removed from messages before they are posted.  (The
  4606.                enter ANSI sequence itself isn't removed; only the leading
  4607.  
  4608.  
  4609.                                    - Page 71 -
  4610.  
  4611.                    PegaSys Main Documentation - Version 0.43
  4612.  
  4613.  
  4614.                ESC character is stripped.  This renders the rest of the
  4615.                sequence useless.  Also, ASCII character 127 is defined as
  4616.                DEL in the ASCII standard, which can cause problems for some
  4617.                systems.)  Enabling this option is recommended for EchoMail
  4618.                and GroupMail bases, as ANSI and 8-bit ASCII characters are
  4619.                usually prohibited to provide compatibility with non-IBM
  4620.                systems.
  4621.  
  4622.  
  4623.  
  4624.  
  4625.  
  4626.  
  4627.  
  4628.  
  4629.  
  4630.  
  4631.  
  4632.  
  4633.  
  4634.  
  4635.  
  4636.  
  4637.  
  4638.  
  4639.  
  4640.  
  4641.  
  4642.  
  4643.  
  4644.  
  4645.  
  4646.  
  4647.  
  4648.  
  4649.  
  4650.  
  4651.  
  4652.  
  4653.  
  4654.  
  4655.  
  4656.  
  4657.  
  4658.  
  4659.  
  4660.  
  4661.  
  4662.  
  4663.  
  4664.  
  4665.  
  4666.  
  4667.  
  4668.  
  4669.  
  4670.  
  4671.  
  4672.                                    - Page 72 -
  4673.  
  4674.                    PegaSys Main Documentation - Version 0.43
  4675.  
  4676.  
  4677.                              _____________________
  4678.  
  4679.                               THE PROTOCOL EDITOR
  4680.                              _____________________
  4681.  
  4682.  
  4683.      The  protocol  editor  allows you to set up  different  protocols  for
  4684.      transferring  files.   The most common protocols  are  ASCII,  Xmodem,
  4685.      Ymodem  and  Zmodem;  they have already been set up  for  you  in  the
  4686.      protocol editor.  All you need to do is place the appropriate  program
  4687.      into any directory that is part of your DOS PATH statement.
  4688.  
  4689.      In order to enable the default protocols, you will need a copy of  the
  4690.      DSZ program.  It is available from most BBSes as "DSZnnnn.ZIP",  where
  4691.      "nnnn" is the release date.  Extract the DSZ.COM program, place it  in
  4692.      a directory contained in your PATH, and you'll be all set.
  4693.  
  4694.      The main screen of the protocol editor looks similar to the one  shown
  4695.      below:
  4696.      ______________________________________________________________________
  4697.  
  4698.       NNN:ACS       :Description
  4699.       ===:==========:======================================================
  4700.      +0              (Q) Quit - abort transfer
  4701.      +1              (Q) Quit - abort batch transfer
  4702.      +2              (Q) Quit - abort resume transfer
  4703.      +3              (B) Batch transfer
  4704.      +4              (N) Skip to next file
  4705.      +5              (A) ASCII
  4706.      +6              (X) Xmodem
  4707.      +7              (C) Xmodem-CRC
  4708.      +8              (Y) Ymodem
  4709.      +9              (Y) Ymodem batch
  4710.      +10             (Y) Ymodem resume
  4711.      +11             (Z) Zmodem
  4712.      +12             (Z) Zmodem batch
  4713.      +13             (Z) Zmodem resume
  4714.  
  4715.      Protocol editor (?=help) :
  4716.      ______________________________________________________________________
  4717.  
  4718.      The  commands available from this menu (displayed by pressing the  "?"
  4719.      key) are:
  4720.  
  4721.           <CR>Redisplay screen
  4722.           (D)elete protocol (I)nsert protocol
  4723.           (M)odify protocol (P)osition protocol
  4724.           (Q)uit
  4725.  
  4726.      and are detailed below:
  4727.  
  4728.           <CR>Redisplay screen -- Displays the menu again, in case
  4729.                something you wished to see scrolled off the screen.
  4730.  
  4731.           (D)elete protocol -- Removes an entry from the protocol list.
  4732.                You will be prompted for the entry number to delete.
  4733.  
  4734.  
  4735.                                    - Page 73 -
  4736.  
  4737.                    PegaSys Main Documentation - Version 0.43
  4738.  
  4739.  
  4740.           (I)nsert protocol -- Inserts a new entry in the protocol list.
  4741.                You will be prompted for the entry number that the new entry
  4742.                should be inserted before, and the number of new entries to
  4743.                insert.
  4744.  
  4745.           (M)odify protocol -- Allows you to change an entry in the
  4746.                protocol list.  Details on modifying entries are given
  4747.                later.
  4748.  
  4749.           (P)osition protocol -- Moves an entry from one position to
  4750.                another.  You will be prompted for the entry number to move
  4751.                and the entry number that it will precede.
  4752.  
  4753.           (Q)uit -- Exits the protocol editor.
  4754.  
  4755.      When  you  select the (M)odify command, you will be prompted  for  the
  4756.      entry number to modify.  After you make your selection, a menu similar
  4757.      to the following example will be displayed:
  4758.      ______________________________________________________________________
  4759.  
  4760.      Protocol #11 of 24
  4761.      !. Type/protocl:Active - Batch protocol
  4762.      1. Keys/descrip:"Z" / "(Z) Zmodem"
  4763.      2. ACS required: ""
  4764.      3. Temp. log   : "%C\dsztemp.log"
  4765.      4. <U>L log    : "%C\xfer.log"
  4766.         <D>L log    : "%C\xfer.log"
  4767.      5. <U>L command: "dsz port %P speed %B rz"
  4768.         <D>L command: "dsz port %P speed %B sz @%L"
  4769.      6. Codes mean  :Transfer bad
  4770.      7. <U>L codes  :(1)""    (2)""    (3)""    (4)""    (5)""    (6)""
  4771.         <D>L codes  :(1)"E"   (2)"e"   (3)"L"   (4)"l"   (5)""    (6)""
  4772.      E. Environ. cmd: "set DSZLOG=%T"
  4773.      I. DL File list: "%C\fi.lst"
  4774.      C. Max DOS chrs:128   P. Log position: Filename: 51 - Status: 1
  4775.  
  4776.      Edit menu (?=help) :
  4777.      ______________________________________________________________________
  4778.  
  4779.      Notice  that  some  of the strings in the above example  have  a  "%x"
  4780.      sequence  of characters.  These are special protocol codes,  and  they
  4781.      are defined as follows:
  4782.  
  4783.           %B        Specifies the current baud rate, as a string of ASCII
  4784.                     digits ("300", "1200", "2400", etc.).
  4785.  
  4786.           %C        Specifies the pathname of the main BBS directory.  Note
  4787.                     that a backslash ("\") is NOT automatically appended,
  4788.                     so it will have to be specified if necessary.
  4789.  
  4790.           %F        Specifies the filename(s) to be transferred.  In the
  4791.                     case of a batch transfer, this MCI indicates where
  4792.                     multiple filenames may be inserted, up to the allowable
  4793.                     length of the command line (defined in option C,
  4794.                     below).
  4795.  
  4796.  
  4797.  
  4798.                                    - Page 74 -
  4799.  
  4800.                    PegaSys Main Documentation - Version 0.43
  4801.  
  4802.  
  4803.           %L        Specifies the name of the file that contains a list of
  4804.                     filenames to be batch downloaded (defined in option I,
  4805.                     below).
  4806.  
  4807.           %T        Specifies the name of the transfer result temporary log
  4808.                     file (defined in option 3, below).
  4809.  
  4810.      Note  that all protocol code MUST BE SPECIFIED IN UPPER CASE, or  they
  4811.      will  NOT work!  These codes are shown on the video display using  MCI
  4812.      color #3 (bright cyan in the default setup).
  4813.  
  4814.      The  commands available from this menu (displayed by pressing the  "?"
  4815.      key) are:
  4816.  
  4817.            #:Modify item   <CR>Redisplay screen
  4818.           ([)Back entry    (])Forward entry
  4819.           (J)ump to entry  (F)irst entry in list
  4820.           (Q)uit and save  (L)ast entry in list
  4821.  
  4822.      and are described below:
  4823.  
  4824.           <CR>Redisplay screen -- Redisplays the menu.
  4825.  
  4826.           ([)Back entry -- Moves the pointer to the previous entry in the
  4827.                protocol list.  If the pointer is at the first entry, this
  4828.                command is ignored.
  4829.  
  4830.           (])Forward entry -- Moves the pointer to the next entry in the
  4831.                protocol list.  If the pointer is at the last entry, this
  4832.                command is ignored.
  4833.  
  4834.           (J)ump to entry -- This command moves the pointer to the user
  4835.                specified entry in the protocol list.  You will be prompted
  4836.                for the entry number to move to.
  4837.  
  4838.           (F)irst entry in list -- Moves the pointer to the first entry in
  4839.                the protocol list.
  4840.  
  4841.           (L)ast entry in list -- Moves the pointer to the last entry in
  4842.                the protocol list.
  4843.  
  4844.           (Q)uit and save -- Saves the current protocol list and returns to
  4845.                the main protocol editor menu.
  4846.  
  4847.      In  addition, you can modify any of the entries shown on  the  screen.
  4848.      They are defined as follows:
  4849.  
  4850.           !    This option allows you to define the type and availability
  4851.                of the current protocol.  The protocol can be enabled,
  4852.                disabled or set to one of the following types:
  4853.  
  4854.                     Single - The protocol will only transfer a single file.
  4855.  
  4856.                     Batch - The protocol will transfer multiple files with
  4857.                          one command.
  4858.  
  4859.  
  4860.  
  4861.                                    - Page 75 -
  4862.  
  4863.                    PegaSys Main Documentation - Version 0.43
  4864.  
  4865.  
  4866.                     Resume - The protocol will transfer one file, and
  4867.                          resume the transfer where it left off (if the
  4868.                          previous transfer was aborted).  For example,
  4869.                          DSZ.COM support Ymodem and Zmodem resume
  4870.                          transfers.
  4871.  
  4872.           1    This option defines the command keys required to select the
  4873.                protocol and a description that will be displayed when a
  4874.                list of protocols is requested.  The description may contain
  4875.                MCI color codes.
  4876.  
  4877.           2    This option defines the ACS requirements that the user must
  4878.                satisfy in order to use the protocol.
  4879.  
  4880.           3    This option defines the name of the file that holds the
  4881.                result log of a file transfer operation.  This temporary log
  4882.                is then used to build the permanent result logs (defined in
  4883.                option 4) and to determine the transfer status after a batch
  4884.                transfer.  Note that not all protocol drivers support a
  4885.                result log.
  4886.  
  4887.           4    This option defines the names of the permanent result log
  4888.                files for both upload and download operations.  Data from
  4889.                the temporary result log file (defined in option 3) are used
  4890.                to build these permanent logs.  Separate log files can be
  4891.                specified for upload and download operations, or a common
  4892.                log file can be used.
  4893.  
  4894.           5    This option defines the commands required to perform file
  4895.                uploading and downloading.  When selected, you will be asked
  4896.                which command (upload or download) to define.  Then, you are
  4897.                asked what type of command it will be.  The four different
  4898.                types are defined as follows:
  4899.  
  4900.                     (A)SCII -- The protocol is used for pure ASCII file
  4901.                          transfers.  In this event, almost all other
  4902.                          options for this protocol (transfer logs, result
  4903.                          codes, etc.) are ignored, as they aren't needed.
  4904.  
  4905.                     (C)ommand -- The entry is assigned to a special
  4906.                          function.  The two functions available are:
  4907.  
  4908.                          Batch -- The entry will not actually transfer a
  4909.                               file, but instead will add the file to the
  4910.                               batch transfer queue.
  4911.  
  4912.                          Next -- The selected file is skipped and the next
  4913.                               file (if a wildcard operation is being
  4914.                               performed) is selected.
  4915.  
  4916.                     (E)xternal -- Allows you to define the actual DOS
  4917.                          command line used in conjunction with the protocol
  4918.                          driver.  Refer to the above list of protocol MCIs
  4919.                          and the documentation for the protocol driver to
  4920.                          create the command necessary to perform the file
  4921.                          transfer.  (Note that the upload command should be
  4922.  
  4923.  
  4924.                                    - Page 76 -
  4925.  
  4926.                    PegaSys Main Documentation - Version 0.43
  4927.  
  4928.  
  4929.                          defined with the protocol driver's "receive file"
  4930.                          option, and the download command should be defined
  4931.                          with the driver's "send file" option.)
  4932.  
  4933.                     (O)ff -- Disables that particular function for the
  4934.                          protocol.  This may be necessary on some protocol
  4935.                          drivers that, for example, allow batch transfers
  4936.                          in one direction but not the other (Ymodem batch,
  4937.                          for example; batch downloading is permitted, but
  4938.                          not batch uploading).
  4939.  
  4940.           6    This option toggles the meaning of the error result codes
  4941.                defined in option 7 (below).  The meaning can be set to
  4942.                "transfer okay" or "transfer bad", depending on the
  4943.                requirements of the protocol driver.
  4944.  
  4945.           7    This option defines the error result codes (for both
  4946.                uploading and downloading) returned by the protocol driver
  4947.                after completing transmission of a file.  Since some drivers
  4948.                can return more than one result code upon completion of a
  4949.                successful (or unsuccessful) operation, up to six codes can
  4950.                be defined.  If there are less than six, fill the remaining
  4951.                entries with a duplicate code (for example, most drivers
  4952.                return only a single value, zero, when an operation is
  4953.                successful; thus, all six entries would contain "0").
  4954.                PegaSys  will use these codes to determine the success or
  4955.                failure of a transfer operation.
  4956.  
  4957.                If you have defined a result log file, this option defines
  4958.                the strings that PegaSys  should compare when determining
  4959.                if a batch transfer is successful.  (This is used in
  4960.                conjunction with option P, below.)
  4961.  
  4962.           E    This option defines the command that sets up an environment
  4963.                string, for protocol drivers that require environment
  4964.                variables to be set up in certain ways.  For example, "SET
  4965.                DSZLOG=%T" would set the DSZ.COM temporary result log
  4966.                filename to the name defined in option 3.  If no environment
  4967.                setup is necessary, this string should be set to NULL ("").
  4968.  
  4969.                *IMPORTANT*:   IF YOU DEFINE AN ENVIRONMENT SETUP COMMAND
  4970.                               WITH THIS OPTION, MAKE SURE THAT IT IS ALSO
  4971.                               DEFINED IN YOUR AUTOEXEC.BAT FILE, OR FILE
  4972.                               TRANSFERS WILL NOT WORK PROPERLY!  (For
  4973.                               example, if you have the result log filename
  4974.                               set to "%C\dsztemp.log", and this option set
  4975.                               to "SET DSZLOG=%T", place "SET DSZLOG=
  4976.                               C:\BBS\DSZTEMP.LOG" in your AUTOEXEC.BAT
  4977.                               file.  Naturally, you should use the name of
  4978.                               your main BBS directory if it's not C:\BBS.)
  4979.  
  4980.           I    This option defines the name of a file in which PegaSys
  4981.                will store the filenames to be transferred in a batch
  4982.                upload operation (for those programs that require it, as
  4983.                opposed to specifying the names of the files directly on the
  4984.                command line).  If a file list file is not required, this
  4985.  
  4986.  
  4987.                                    - Page 77 -
  4988.  
  4989.                    PegaSys Main Documentation - Version 0.43
  4990.  
  4991.  
  4992.                string should be set to NULL ("").
  4993.  
  4994.           C    This option defines the maximum number of characters allowed
  4995.                on the DOS command line.  The default is 128, which is the
  4996.                normal amount allowed by DOS.  Some DOS enhancement
  4997.                programs, however, allow for more characters on a command
  4998.                line.  If you are using one of these enhancement programs,
  4999.                you may wish to modify this field to contain the number of
  5000.                characters allowed by the enhancement program.
  5001.  
  5002.           P    This option defines the positions, on a single line of the
  5003.                temporary result log, of the filename and return status
  5004.                (starting from position #1).  If no temporary result log is
  5005.                defined, then these values are ignored.  This is used (in
  5006.                conjunction with option 7, above) to determine the status of
  5007.                batch transfer operations.
  5008.  
  5009.  
  5010.  
  5011.  
  5012.  
  5013.  
  5014.  
  5015.  
  5016.  
  5017.  
  5018.  
  5019.  
  5020.  
  5021.  
  5022.  
  5023.  
  5024.  
  5025.  
  5026.  
  5027.  
  5028.  
  5029.  
  5030.  
  5031.  
  5032.  
  5033.  
  5034.  
  5035.  
  5036.  
  5037.  
  5038.  
  5039.  
  5040.  
  5041.  
  5042.  
  5043.  
  5044.  
  5045.  
  5046.  
  5047.  
  5048.  
  5049.  
  5050.                                    - Page 78 -
  5051.  
  5052.                    PegaSys Main Documentation - Version 0.43
  5053.  
  5054.  
  5055.                                _________________
  5056.  
  5057.                                 THE MENU EDITOR
  5058.                                _________________
  5059.  
  5060.  
  5061.      PegaSys 's  menu system is the base of the entire system's  structure;
  5062.      almost  every  command that a user will ever enter  can  be  modified,
  5063.      added to, and deleted from your BBS with the use of the menu editor.
  5064.  
  5065.      The menu system is broken up into individual menu FILES, each of which
  5066.      define  the different menus of your system.  The menu files all  exist
  5067.      in  your  MENUS directory, and all have the file extension  of  "MNU".
  5068.      One  advantage  of having a multiple menu-file system, over  a  single
  5069.      menu-file  system,  is  that other people who  write  PegaSys   add-on
  5070.      utilities, such as online doors, can include the menu file with  their
  5071.      programs, minimizing the total amount of work necessary on the SysOp's
  5072.      part.
  5073.  
  5074.  
  5075.      --------------------
  5076.      THE MAIN EDITOR MENU
  5077.      --------------------
  5078.  
  5079.      Upon  entry  to the Menu Editor, you will be presented with  a  screen
  5080.      similar to the following (compressed slightly to fit onto the page):
  5081.      ______________________________________________________________________
  5082.  
  5083.      PegaSys  Menu Editor
  5084.  
  5085.       Directory of  C:\BBS\MENUS\*.mnu
  5086.  
  5087.      ARCHIVE  MNU  AUTO     MNU  BATCH    MNU  BBSLIST  MNU  FILE     MNU
  5088.      GOODBYE  MNU  MAIN     MNU  MSG      MNU  ONLINE   MNU  PERSONAL MNU
  5089.      SHUTTLE  MNU  SYSOP    MNU
  5090.             12 File(s)    nnnnnn bytes free
  5091.  
  5092.      Menu editor (?=help) :
  5093.      ______________________________________________________________________
  5094.  
  5095.      The commands available at this screen are:
  5096.  
  5097.           (D)elete menu file - This command allows you to erase any of the
  5098.                *.MNU files in the MENUS directory.
  5099.  
  5100.           (I)nsert menu file - This command will generate a new *.MNU file
  5101.                in the MENUS directory with just one menu command on it, all
  5102.                ready to be used.
  5103.  
  5104.           (M)odify menu file - This is where you get to load in one of the
  5105.                *.MNU files and modify the menu commands and structure of
  5106.                the menu.
  5107.  
  5108.           (Q)uit - Exits the menu editor.
  5109.  
  5110.  
  5111.  
  5112.  
  5113.                                    - Page 79 -
  5114.  
  5115.                    PegaSys Main Documentation - Version 0.43
  5116.  
  5117.  
  5118.      When you execute the (M)odify command, you will be asked for the  menu
  5119.      to  modify.  In this case, we are using the main menu ("MAIN")  as  an
  5120.      example.   When you enter the name of the menu, the following menu  is
  5121.      displayed (again, compressed to fit onto the page):
  5122.      ______________________________________________________________________
  5123.  
  5124.      Modifying menu: MAIN
  5125.  
  5126.      NN KK-Typ-MString         NN KK-Typ-MString         NN KK-Typ-MString
  5127.      -- ---------------------- -- ---------------------- -- ---------------
  5128.      1  *  -/  sysop           10 N  ME  1               19 Y  OY
  5129.      2  A  -/  auto            11 O  -/  goodbye         20 .  -/  online
  5130.      3  B  -/  bbslist         12 /O HM                  21 $  O$  60;600
  5131.      4  C  OC  1               13 P  -/  personal        22 !  MA  17
  5132.      5  I  OI                  14 S  OS                  23 !  -/  md
  5133.      6  F  -^  file            15 T  -S  *> Entered TFil 24 CLE-^  main;C
  5134.      7  H  OM                  16 T  OT                  25 XXXDD  activity
  5135.      8  L  -F  user.log        17 V  OV
  5136.      9  M  -^  msg             18 X  OP  22
  5137.  
  5138.      Menu editor (?=help) : ?
  5139.      ______________________________________________________________________
  5140.  
  5141.      In  this display, the command number ("NN"), the keys used to  execute
  5142.      the  command  by users ("KK"), the type of command  ("Typ"),  and  the
  5143.      command  data  ("MString") are all displayed at once.   Other  display
  5144.      formats are available, and are explained later on in this section.
  5145.  
  5146.      The following are descriptions of the commands available here:
  5147.  
  5148.           (D)elete command - Removes one of the menu commands from the
  5149.                current menu loaded.  There is a 50 command limitation for
  5150.                each menu, so get into the habit of deleting commands that
  5151.                are no longer useful.
  5152.  
  5153.           (I)nsert command - Inserts new menu commands somewhere in the
  5154.                menu.  It is possible to insert more than one menu command
  5155.                at once using this option, rather than repeating the same
  5156.                (I)nsert sequence several times.
  5157.  
  5158.           (L)ong generic menu - Displays how the current menu's generic
  5159.                tutorial looks currently.  An alternative to repeatedly
  5160.                modifying the menu, exiting the menu-editor, looking at the
  5161.                menu, re-entering the menu, etc, etc.
  5162.  
  5163.           (M)odify commands - This command allows you to modify the menu
  5164.                command information of a menu command in the current menu,
  5165.                whether newly created or old.  Menu modification is
  5166.                discussed in detail later.
  5167.  
  5168.           (P)osition menu commands - This command allows you to rearrange
  5169.                the order of the menu commands on the menu.  Although useful
  5170.                for linking commands (see the special section on linking
  5171.                commands), it is *especially* useful for making a good,
  5172.                finished product out of your generic menus (if you use
  5173.                them).
  5174.  
  5175.  
  5176.                                    - Page 80 -
  5177.  
  5178.                    PegaSys Main Documentation - Version 0.43
  5179.  
  5180.  
  5181.           (S)hort generic menu - Shows how the current menu's normal
  5182.                generic menu looks currently.  Again, as with the (L)ong
  5183.                command, it is a speed alternative to repeatedly exiting the
  5184.                menu editor to check how the menu looks after each
  5185.                modification.
  5186.  
  5187.           (T)oggle display type - There are two formats which PegaSys  will
  5188.                use to output the listing of menu commands on the current
  5189.                menu; this command is used to toggle between the two.  One
  5190.                of them is shown up above; it is more concise, and takes up
  5191.                less space than the alternate one (which is more
  5192.                descriptive).
  5193.  
  5194.           (X)Menu data/command data display mode toggle - Toggles between
  5195.                either of the two menu command list modes in (T), and
  5196.                another, separate list of information about the current menu
  5197.                (which is described in detail later).
  5198.  
  5199.      -------------------------
  5200.      MENU COMMAND MODIFICATION
  5201.      -------------------------
  5202.  
  5203.      When you execute the (M)odify command, you will be asked which command
  5204.      to modify.  After you enter the command number, the following menu  is
  5205.      displayed:
  5206.      ______________________________________________________________________
  5207.  
  5208.      Menu filename: MAIN
  5209.      Command #1 of 25
  5210.  
  5211.      1. Long descript :(*)SysOp Menu - Perform system maintenance
  5212.      2. Short descript:(*)SysOp Menu
  5213.      3. Cmd letters   :*
  5214.      4. ACS required  :"s200"
  5215.      5. Cmdkeys       :-/
  5216.      6. MString       :sysop
  5217.      7. Flags         :None
  5218.      Q. Quit
  5219.  
  5220.      Edit menu: (1-8,[,],F,J,L,Q,?) :
  5221.      ______________________________________________________________________
  5222.  
  5223.      This  is probably starting to get confusing right about now!   If  you
  5224.      ARE  getting confused, don't worry; you'll understand it soon  enough,
  5225.      after  a  little  usage.  From here, the  following  modification  and
  5226.      movement commands are available:
  5227.  
  5228.           1    This field stores a long description of the menu command,
  5229.                used when listing a generic tutorial of the current menu.
  5230.  
  5231.           2    This field stores a shorter description of the menu command,
  5232.                and is used when the BBS generates a generic menu.  If the
  5233.                short description is longer than the column size of the
  5234.                generic menu, the description is shortened to fit neatly
  5235.                into the space allocated to it.  A large sized description
  5236.                field is provided to allow the SysOp to put whatever kind of
  5237.  
  5238.  
  5239.                                    - Page 81 -
  5240.  
  5241.                    PegaSys Main Documentation - Version 0.43
  5242.  
  5243.  
  5244.                colors he wants into it (color changes take up two
  5245.                characters each in this and ALL strings).
  5246.  
  5247.           3    This is the actual string that the user enters when he wants
  5248.                to execute the command.  If the command letters field has
  5249.                only one character in it, the command will be executed
  5250.                immediately after the user presses the one character; he
  5251.                need not even press [ENTER] afterwards.
  5252.  
  5253.                If the first character of the command letters is a slash
  5254.                character ("/"), the command letters must be two characters
  5255.                in length.  The user must enter the slash character ("/"),
  5256.                and the second character of the command letters to execute
  5257.                the command.  After that, [ENTER] does not need to be
  5258.                pressed; the command automatically continues.  For example:
  5259.                if the command letters are "/O", the user must enter "/O",
  5260.                but does NOT need to press [ENTER].
  5261.  
  5262.                If the command letters have more than one character in them,
  5263.                and the first character of the command letters is NOT a
  5264.                slash character ("/"), the user must enter two slashes in a
  5265.                row ("//"), and then the rest of the command, and press
  5266.                [ENTER].  For example, if the command letters are "YELL",
  5267.                the user must enter "//YELL", and then press [ENTER].
  5268.  
  5269.           4    This is the ACS requirement that the user must satisfy in
  5270.                order to have access to the command.  You may set up two or
  5271.                more menu entries to execute different menu commands for
  5272.                opposite or varying access conditions (see the section on
  5273.                linking commands).
  5274.  
  5275.           5    This is the type of command to be executed.  A full
  5276.                explanation of EVERY possible type of menu command is in the
  5277.                "Menu System Commands" section.  This field must be two
  5278.                characters long, or nothing will be executed.
  5279.  
  5280.           6    This string contains miscellaneous command-particular
  5281.                information; each command uses this information differently.
  5282.                The MString used by each command is defined alongside the
  5283.                command keys in the "Menu System Commands" section, along
  5284.                with a short 5-10 line description of the command, what it
  5285.                does, and what all is possible with it.
  5286.  
  5287.           7    There are several functions for each command which may be
  5288.                flagged on or off according to how they should be set up.
  5289.                When you press the "7" key from this section, the following
  5290.                flags can be changed:
  5291.  
  5292.                     (H)idden command - This makes the command "hidden".
  5293.                          This means that whether the user has access to the
  5294.                          command or not, the command will NEVER be
  5295.                          displayed on ANY generic menu.
  5296.  
  5297.                     (U)nhidden command - This makes the command "unhidden".
  5298.                          This means that the command will always be
  5299.                          displayed to all users on any generic menus,
  5300.  
  5301.  
  5302.                                    - Page 82 -
  5303.  
  5304.                    PegaSys Main Documentation - Version 0.43
  5305.  
  5306.  
  5307.                          whether they have access to the command or not.
  5308.                          If they do not have access to it, the command
  5309.                          letters are displayed in generic color #1 (the
  5310.                          same color as the surrounding brackets).
  5311.  
  5312.                Note that if neither flag is set, the default method
  5313.                (display the command if the user has access to it, and hide
  5314.                the command if the user doesn't) is used.  If *BOTH* flags
  5315.                are set, the results are unpredictable!
  5316.  
  5317.           [    Displays the previous menu command.  If at the first
  5318.                command, this command does nothing.
  5319.  
  5320.           ]    Displays the next menu command.  If at the last command,
  5321.                this command does nothing.
  5322.  
  5323.           F    Displays the first menu command.
  5324.  
  5325.           J    Displays the specified menu command.
  5326.  
  5327.           L    Displays the last menu command.
  5328.  
  5329.  
  5330.      -----------------------------
  5331.      MENU INFORMATION MODIFICATION
  5332.      -----------------------------
  5333.  
  5334.      When  you execute the "X" command at the main editor menu, you  switch
  5335.      the display to show the other menu information:
  5336.      ______________________________________________________________________
  5337.  
  5338.      Menu filename: MAIN
  5339.      1. Menu name     :**> PegaSys  Bulletin Board System <**
  5340.                       :Main Menu
  5341.      2. Help files    :MAIN@S / *Generic*
  5342.      3. Prompt        :^4Time Left: [^3@T^4] (^3?^4=^3help^4)@M^4Main Menu
  5343.      ^2:^6
  5344.      (Time Left: [01:00:00] (?=help)
  5345.      Main Menu :)
  5346.      4. ACS required  :""
  5347.      5. Password      :*None*
  5348.      6. Fallback menu :MAIN
  5349.      7. Forced ?-level:None
  5350.      8. Generic info  :4 cols - 3/5/4
  5351.      9. Flags         :-----
  5352.      Q. Quit
  5353.  
  5354.      Menu editor (?=help) :
  5355.      ______________________________________________________________________
  5356.  
  5357.      The following commands are available from this menu:
  5358.  
  5359.           1    This field contains a description of the current menu
  5360.                (example: "PegaSys  BBS Main Menu").  One to three
  5361.                description lines can be defined.
  5362.  
  5363.  
  5364.  
  5365.                                    - Page 83 -
  5366.  
  5367.                    PegaSys Main Documentation - Version 0.43
  5368.  
  5369.  
  5370.           2    This command inputs the TWO filenames which make up the
  5371.                menus of your menu system.  The generic menus are specified
  5372.                in EITHER case by setting the strings to NULL ("").  NEITHER
  5373.                filename should have a file extension.  PegaSys
  5374.                automatically searches for and displays MSG, 40C, ANS, or
  5375.                ANx, depending on the situation at hand (the user's
  5376.                account).
  5377.  
  5378.                The first filename is the NORMAL help display, and the
  5379.                second filename is the tutorial help display.  If a "@S"
  5380.                occurs in either of these two filenames, it is replaced with
  5381.                the current user's SL, and THAT file is displayed.  If that
  5382.                file is not found, the "@S" is taken out and THAT is
  5383.                displayed.  If that file is still not present, a generic
  5384.                menu is displayed.  Example:  The filename is "MAIN@S", and
  5385.                the user's SL is 60.  If MAIN60.* does not exist, and MAIN.*
  5386.                does not exist, a generic menu will be displayed.
  5387.  
  5388.                Note that tutorial menus can be turned off entirely on any
  5389.                menu by entering the string "*OFF*" (without quotes) as the
  5390.                tutorial filename.
  5391.  
  5392.           3    This field contains the actual menu prompt that is displayed
  5393.                before it will accept commands from the user online.  It can
  5394.                be up to 120 characters long, allowing many SysOp's to
  5395.                design VERY creative prompt strings.  Prompt MCI is
  5396.                available in this field.
  5397.  
  5398.           4    This is the ACS requirement that the user must satisfy in
  5399.                order to access the menu.  If the user does not have access,
  5400.                and he/she enters the menu, they will be sent back to the
  5401.                fallback menu (specified by option 6).
  5402.  
  5403.           5    If a menu has a password attached to it and a user attempts
  5404.                to enter the menu in any way, the password will be prompted
  5405.                for.  If correctly entered, the user enters the menu;
  5406.                otherwise, the fallback menu is loaded.
  5407.  
  5408.           6    This is a legal menu file which is loaded whenever the user
  5409.                does not have access to the current menu (see options 4 and
  5410.                5) or some type of critical menu error occurs.
  5411.  
  5412.           7    The help level setting that is forced when the user enters
  5413.                the menu.  The help levels are:
  5414.  
  5415.                     0 -- No help level forcing.
  5416.                     1 -- Expert level (only the prompt is shown).
  5417.                     2 -- Normal level (the normal menu, or the short
  5418.                               generic menu, is displayed).
  5419.                     3 -- Novice level (the tutorial menu, or the long
  5420.                               generic menu, is displayed).
  5421.  
  5422.           8    This entry includes all the information that is used to
  5423.                generate the generic menus.  The number of columns to use,
  5424.                and the three colors used to colorize the menu command
  5425.                descriptions, are included here.
  5426.  
  5427.  
  5428.                                    - Page 84 -
  5429.  
  5430.                    PegaSys Main Documentation - Version 0.43
  5431.  
  5432.  
  5433.           9    There are several functions for each menu that may be
  5434.                flagged on or off.  The available flags are:
  5435.  
  5436.                     (C)lear screen before menu - This tells PegaSys  to
  5437.                          clear the screen every time the normal generic
  5438.                          menu or generic tutorial menu is displayed.  It
  5439.                          should be used in conjunction with the "(P)Force
  5440.                          pause before menu display" toggle, so that user
  5441.                          gets a chance to see important information before
  5442.                          the screen clears if he/she is not in expert mode.
  5443.  
  5444.                     (D)on't center the menu titles - This tells PegaSys  to
  5445.                          leave the menu titles uncentered (i.e. left
  5446.                          justified).  This ONLY affects the three menu
  5447.                          titles at the top, not any of the Generic sub
  5448.                          titles.
  5449.  
  5450.                     (N)o menu prompt toggle - This can be used if you want
  5451.                          to put the menu prompt for the menu RIGHT IN
  5452.                          THE .MSG OR .ANS file.  PegaSys  will not display
  5453.                          any menu prompt whatsoever, and will totally
  5454.                          ignore the current menu prompt, whatever it is.
  5455.  
  5456.                     (P)Force pause before menu display - The screen will be
  5457.                          paused before the menu is displayed, if this
  5458.                          option is toggled on.  This allows the user to see
  5459.                          information from the previous command entered, if
  5460.                          the menu clears the screen.
  5461.  
  5462.                     (T)Auto-time display toggle - If this is set to ON, a
  5463.                          "time-left" string will be inserted DIRECTLY
  5464.                          before the prompt of the current menu.  The format
  5465.                          is as follows:
  5466.  
  5467.                               "[<Time Left - HH:MM:SS>]"
  5468.  
  5469.                          Many people find it more desirable to use the @T
  5470.                          MCI command to insert a HH:MM:SS type format time
  5471.                          left string into their menu-prompt, being able to
  5472.                          customize the system even further.
  5473.  
  5474.  
  5475.      ----------------------------
  5476.      SPECIAL GLOBAL MENU COMMANDS
  5477.      ----------------------------
  5478.  
  5479.      There are several internal commands that may be used from ANY menu  on
  5480.      the BBS (excepting the shuttle logon menu, SHUTTLE.MNU); their command
  5481.      letters therefore cannot be used in any menu command.  These  commands
  5482.      are:
  5483.  
  5484.           ?         Pressing "?" will ALWAYS get help on ANY menu.
  5485.                     Pressing it will raise the help level of the user by
  5486.                     one.  Since there are only three help levels, pressing
  5487.                     it at the third one has no effect.  Help level 1 is
  5488.                     where no help whatsoever is displayed (expert mode).
  5489.  
  5490.  
  5491.                                    - Page 85 -
  5492.  
  5493.                    PegaSys Main Documentation - Version 0.43
  5494.  
  5495.  
  5496.                     Help level 2 is where the main help is displayed
  5497.                     (normal mode).  Help level 3 is when the tutorial help
  5498.                     is displayed (novice mode).  Hitting [ENTER] will drop
  5499.                     the help level down to the user's normal level again.
  5500.                     Available to all users.
  5501.  
  5502.           =         This command will display a list of ALL the menu
  5503.                     commands on the current menu loaded, and the contents
  5504.                     of the current menu "stack" (used by the "-/", "-\",
  5505.                     and "-^" menu commands).  Available only to users with
  5506.                     Co-SysOp access or higher.
  5507.  
  5508.           |         This command will display the current version info, the
  5509.                     date the BBS.EXE and BBS.OVR files were last compiled
  5510.                     on by the authors, and the registration information, if
  5511.                     available.  Available to all users.
  5512.  
  5513.           //\\      When these characters precede a command, the rest of
  5514.                     the command is executed just like a normal menu
  5515.                     command; the command keys are the first two characters
  5516.                     immediately afterwards, and the rest of the command is
  5517.                     the MString of the command.  For example, "//\\OC1;WHY
  5518.                     DO YOU WANT TO CHAT?!" would execute the Chat menu
  5519.                     command, with chat-reason question "WHY DO YOU WANT TO
  5520.                     CHAT?!", sending mail to user #1 if the SysOp does not
  5521.                     respond to the call.  Available only to users with SL
  5522.                     255.
  5523.  
  5524.           ;         When the ";" character is pressed, the rest of the
  5525.                     command is treated as a command macro.  Every other
  5526.                     occurrence of ";" in the command is replaced with a
  5527.                     <CR>.  For example, entering ";MPThis is a test;SysOp;"
  5528.                     from the main or file menus would ("M") enter the
  5529.                     message menu, ("P") post a message, ("This is a test")
  5530.                     enter the subject of the message, (";") include a <CR>
  5531.                     at the end, and "address" the message to "All" (the
  5532.                     last ";").
  5533.  
  5534.  
  5535.      -------------------------
  5536.      THE HELP-FILE MENU SYSTEM
  5537.      -------------------------
  5538.  
  5539.      PegaSys   has  a  VERY  complicated way of  displaying  text  files  -
  5540.      particularly  the menus.  Here is a list of possible  file  extensions
  5541.      and their meanings:
  5542.  
  5543.           MSG       Contains PegaSys  color codes.  Displayed with colors
  5544.                     to those who have ANSI, but with NO color to those
  5545.                     without ANSI.
  5546.  
  5547.           40C       Displayed to users with less than 80 column screen
  5548.                     displays.
  5549.  
  5550.           ANS       Displayed to those users who have ANSI.
  5551.  
  5552.  
  5553.  
  5554.                                    - Page 86 -
  5555.  
  5556.                    PegaSys Main Documentation - Version 0.43
  5557.  
  5558.  
  5559.           AN1-AN9   If a file with an extension of AN1 exists, PegaSys
  5560.                     will RANDOMLY pick and display a file somewhere in the
  5561.                     range of <ANS, AN1-AN9>.  For example, if WELCOME.ANS,
  5562.                     WELCOME.AN1, and WELCOME.AN2 all exist, PegaSys  will
  5563.                     randomly choose one of them to display when WELCOME.*
  5564.                     needs to be displayed by the system.
  5565.  
  5566.           A0S-A6S   These ANSIs are displayed on different days of the
  5567.                     week, ranging from 0:Sunday to 6:Saturday.  They can be
  5568.                     used in conjunction with the random ANSIs, too.  (For
  5569.                     example, WELCOME.A01 means the first (1) random ANSI
  5570.                     displayed on Sundays).  Don't worry if this system
  5571.                     seems to be too complicated.  A better system is on the
  5572.                     way.
  5573.  
  5574.      The  above is what is meant whenever you see something like  WELCOME.*
  5575.      or  SL50.*,  etc.   PegaSys   will search  for  any  of  these  highly
  5576.      specialized files, depending on the user's account.
  5577.  
  5578.      Therefore,  the  menu system can be VERY complicated if  you  want  to
  5579.      provide for all of the possibilities.  It doesn't end THERE,  however!
  5580.      Security-sensitive  menus are possible through PegaSys .  In the  help
  5581.      filename  configuration  of the menus, you can specify a  "@S"  to  be
  5582.      replaced  with the user's SL, and displayed.  If their  particular  SL
  5583.      file does not exist, it will display a common one, which replaces "@S"
  5584.      with a null string (i.e. "MAIN@S" would become "MAIN").  You can  have
  5585.      a  MSG, 40C, and 10 ANSI text files for EACH of the  security  levels!
  5586.      While  it's doubtful all these options will ever be used all at  once,
  5587.      they  provide  some real interesting configuration abilities  for  the
  5588.      system.
  5589.  
  5590.      The  following  is  an  explanation of  what  goes  on  under  several
  5591.      different  conditions,  for a sample configuration of the  main  menu.
  5592.      Here's the logic of this, if a user with ANSI and 255 SL is on and the
  5593.      main menu file is set to "MAIN@S":
  5594.  
  5595.           If (MAIN255.ANS exists) then
  5596.           {
  5597.                If (MAIN255.AN1 exists) then
  5598.                {
  5599.                     The system chooses a random MAIN255.AN?, where "?" is
  5600.                     either an "S" or "1"-"9".
  5601.                }
  5602.                Otherwise
  5603.                     MAIN255.ANS is displayed.
  5604.           }
  5605.           Otherwise
  5606.                If (MAIN255.MSG exists) then
  5607.                     MAIN255.MSG is displayed
  5608.                Otherwise
  5609.                {
  5610.                     It repeats the ENTIRE process again, searching this
  5611.                     time for MAIN.*.  If no files were found THEN, it will
  5612.                     display a generic menu.
  5613.                }
  5614.  
  5615.  
  5616.  
  5617.                                    - Page 87 -
  5618.  
  5619.                    PegaSys Main Documentation - Version 0.43
  5620.  
  5621.  
  5622.      -----------------------
  5623.      THE GENERIC MENU SYSTEM
  5624.      -----------------------
  5625.  
  5626.      The  generic menu system in PegaSys  is just another name for a  self-
  5627.      generated  menu system.  PegaSys  will automatically generate its  own
  5628.      help  menus  in two cases: if the menu help files specified  the  menu
  5629.      editor do not already exist, or if the SysOp explicitly uses the  menu
  5630.      editor to configure PegaSys  to generate them.
  5631.  
  5632.      Many  other  BBS  programs use generic menus,  and  unfortunately,  it
  5633.      shows:   They  are usually very rigid, allowing very little  room  for
  5634.      creativity (making it a carbon-copy of other systems, and giving it  a
  5635.      "bland"  look).   PegaSys  solves this problem by making  the  generic
  5636.      menus extremely configurable.
  5637.  
  5638.      First of all, the number of columns the BBS uses to generate the menus
  5639.      is  configurable.   The REALLY nice feature,  however,  is  PegaSys 's
  5640.      ability  to colorize menu command descriptions automatically, with  no
  5641.      effort  on the SysOp's part.  If you want to change the  ENTIRE  color
  5642.      scheme  of  a  certain  menu,  all you have to  do  is  change  a  few
  5643.      parameters  in the menu editor.  Each menu can have a different  color
  5644.      scheme, as well.
  5645.  
  5646.      When  normal  generic menus are displayed, they are displayed  in  the
  5647.      following format (this is an example using the 4 column size):
  5648.  
  5649.                                <<< Menu Title >>>
  5650.  
  5651.      [ Column #1     ][ Column #2     ][ Column #3     ][ Column #4     ]
  5652.      [ Column #1     ][ Column #2     ][ Column #3     ][ Column #4     ]
  5653.      [ Column #1     ][ Column #2     ]
  5654.  
  5655.      All columns are left-justified, meaning they begin at column 1 of  the
  5656.      screen.   Descriptions  which are too long to fit  neatly  within  the
  5657.      columns are shortened.
  5658.  
  5659.      The  furthest position any of the menu description lines go out to  on
  5660.      the right of the screen is used to calculate the position of the  menu
  5661.      titles;  they  are centered on the screen according  to  this  (unless
  5662.      centering has been disabled with the "(D)on't center the menu  titles"
  5663.      flag).
  5664.  
  5665.      When  generic  menu tutorials are displayed, they are  displayed  like
  5666.      this:
  5667.  
  5668.                                <<< Menu Title >>>
  5669.  
  5670.      [ Command #1 ........                           Max length = 70 chrs ]
  5671.      [ Command #2 ........                                                ]
  5672.      [ Command #3 ........                                                ]
  5673.        .
  5674.        .
  5675.        .
  5676.  
  5677.  
  5678.  
  5679.  
  5680.                                    - Page 88 -
  5681.  
  5682.                    PegaSys Main Documentation - Version 0.43
  5683.  
  5684.  
  5685.      The menu titles are ALWAYS centered, using the same formula as in  the
  5686.      normal generic menu displays (unless centering has been disabled  with
  5687.      the "(D)on't center the menu titles" flag).
  5688.  
  5689.      When colorizing the menu descriptions (short or long, in the normal or
  5690.      tutorial  menus,  respectively),  PegaSys   uses  the  three  "generic
  5691.      colors"  specified in the menu by the menu editor.  The  command  keys
  5692.      (key  sequences used to execute the command) are searched out, and  if
  5693.      found  in the description string, they are colorized using  color  #2.
  5694.      The  "bracket" characters around the command keys are colorized  using
  5695.      color  #1, and all other characters in the description  are  colorized
  5696.      using color #3.  Note that if an online user does NOT have access to a
  5697.      command, and it is an unhidden command, the command WILL be displayed,
  5698.      but   with   the  command-keys  colorized  using   color   #1.    This
  5699.      differentiates on the screen between commands the user HAS access  to,
  5700.      and those they DO NOT.
  5701.  
  5702.      Note that the "bracket" characters need not be brackets.  They can  be
  5703.      any types of characters:  Parentheses ("(" and ")"), dashes ("-"),  or
  5704.      any  of the characters from the IBM extended character set.   Whatever
  5705.      they are, PegaSys  will simply colorize whatever is on either side  of
  5706.      the   command  key  sequence.   PegaSys   has  no  problems   handling
  5707.      descriptions such as "F)ile section", either, which have brackets only
  5708.      on ONE side of the command key sequence ("F").
  5709.  
  5710.      The following diagram should help clear all this up:
  5711.  
  5712.            ________________ Color #1 (the "(" and ")" characters)
  5713.           | |
  5714.           (F)ile section
  5715.            | ^^^^^^^^^^^\__ Color #3 (all other characters - "ile section")
  5716.            |_______________ Color #2 (the "F" character)
  5717.  
  5718.      When  a  command with command letters of "GTITLE"  is  encountered  by
  5719.      PegaSys ,  it is treated as a generic sub-title.  This means that  the
  5720.      description  is centered and placed on a separate line.  For  example,
  5721.      you  could put the words "SysOp Commands" as a sub-title  before  your
  5722.      listing  of SysOp commands in the file section.  PegaSys  looks for  a
  5723.      NEW  set  of  Generic color codes in the MString,  in  the  format  of
  5724.      "<Color1>;<Color2>;<Color3>".  If they DO exist, all commands for  the
  5725.      remainder  of  the  menu will be displayed in the new  set  of  colors
  5726.      (unless, of course, another "GTITLE" is encountered).
  5727.  
  5728.      That's  just about all there is to the colorizing methods!   A  rather
  5729.      simple system, but it tends to encourage creativity on the part of the
  5730.      SysOp  --  more, probably, than any other  comparable  self-generating
  5731.      menu system.
  5732.  
  5733.  
  5734.      ---------------------
  5735.      LINKING MENU COMMANDS
  5736.      ---------------------
  5737.  
  5738.      One  of the most powerful features of the PegaSys  menu system is  its
  5739.      ability  to chain, or "link", different menu commands together.   Many
  5740.      things are possible using this feature.
  5741.  
  5742.  
  5743.                                    - Page 89 -
  5744.  
  5745.                    PegaSys Main Documentation - Version 0.43
  5746.  
  5747.  
  5748.      PegaSys 's method of linked commands is the simplest possible  method,
  5749.      as  any  programmer would attest to.  When PegaSys   executes  a  menu
  5750.      command,  it will execute all commands which have the command  letters
  5751.      which were entered by the user.  Therefore, if two different  commands
  5752.      both  have the same command letters in them, both commands are  simply
  5753.      executed  in  the order in which they are placed in  the  menu  editor
  5754.      (this is one of the purposes of the P:osition command).
  5755.  
  5756.      One possibility of linking commands is to display a text file (Cmdkeys
  5757.      -F)  and then prompt the user whether he wants to send mail to a  user
  5758.      on  your BBS (Cmdkeys ME).  This can be used for "SIGs" on your  board
  5759.      that require users to "sign up" to receive access to them.
  5760.  
  5761.      Another possibility is to link the file section's area-change  command
  5762.      with the current file section statistic's lister command (Cmdkeys F$).
  5763.      This  will show the stats on the file base you have changed to,  every
  5764.      time you change areas using the "A" command.
  5765.  
  5766.      Think  of the menu editor as a kind of limited  programming  language.
  5767.      MANY, MANY things are possible, if you only use your imagination!
  5768.  
  5769.      You  should  remember  one  important  thing  when  linking   commands
  5770.      together.  ONLY put a short and long description on the FIRST  command
  5771.      in  the chain of commands, and leave the rest set to NULL.  This  will
  5772.      prevent  a  command from being displayed several  times  when  generic
  5773.      menus are displayed.
  5774.  
  5775.      One  final feature:  If a command (or several commands)  with  command
  5776.      letters "FIRSTCMD" are encountered in any menu, after it has just been
  5777.      loaded  (either  "loaded", "called", or "returned to"), they  will  be
  5778.      executed  *first*,  before  the  user is  allowed  to  enter  commands
  5779.      themselves.   This can be useful in the file section to  remind  users
  5780.      that they still have files left in their upload/download batch  queues
  5781.      (with  the "B?" command keys), and for many other such  things.   With
  5782.      the  powerful  ACS system, you could even have  PegaSys   remind  (for
  5783.      example)  user  #50 that they should read their mail, on  the  message
  5784.      menu.
  5785.  
  5786.  
  5787.      ----------------------------------
  5788.      MENU COMMANDS AVAILABLE IN PEGASYS
  5789.      ----------------------------------
  5790.  
  5791.      Due  to the fact that there are so many available commands,  and  that
  5792.      thorough  descriptions  of  each command take up so  much  space,  the
  5793.      available  commands  are described in a separate  documentation  file,
  5794.      MENUCMD.MSG. Consult MENUCMD.MSG for descriptions of all menu commands
  5795.      available in PegaSys.
  5796.  
  5797.  
  5798.  
  5799.  
  5800.  
  5801.  
  5802.  
  5803.  
  5804.  
  5805.  
  5806.                                    - Page 90 -
  5807.  
  5808.                    PegaSys Main Documentation - Version 0.43
  5809.  
  5810.  
  5811.                           ____________________________
  5812.  
  5813.                            THE SCHEDULED EVENT EDITOR
  5814.                           ____________________________
  5815.  
  5816.  
  5817.      The Scheduled Event Editor allows you to define "events" that are  run
  5818.      at defined times throughout the day/week/month.  Various events can be
  5819.      run,  such  as BBS enhancements (updating bulletins,  performing  file
  5820.      section maintenance, packing the message bases, etc.) or DOS utilities
  5821.      (Norton Speed Disk, etc.).
  5822.  
  5823.      How do scheduled events affect users, specifically their time on-line?
  5824.      If  a  user  logs on, and the amount of time allowed  will  overlap  a
  5825.      scheduled   event,  the  user's  allowed  time  online  is   decreased
  5826.      accordingly.    If  a  user  is  online  and  a  scheduled  event   is
  5827.      approaching, he will be alerted prior to the event.
  5828.  
  5829.      The  Event Editor can be accessed through the WFC menu and  the  SysOp
  5830.      menu.  Upon executing, the following screen is displayed:
  5831.      ______________________________________________________________________
  5832.  
  5833.       NN:Description                :Typ:Bsy:Time :Len:Days   :ExecData
  5834.       ==:===========================:===:===:=====:===:=======:============
  5835.      -1  A NEW PegaSys  Event        DOS 5   00:00 1   ------- event.bat
  5836.  
  5837.      Event editor (?=help) :
  5838.      ______________________________________________________________________
  5839.  
  5840.      The following commands are available from this screen:
  5841.  
  5842.            <CR>Redisplay menu
  5843.            (D)elete   (I)nsert
  5844.            (M)odify   (P)osition
  5845.            (Q)uit
  5846.  
  5847.           <CR>Redisplay menu -- This will redisplay the listing of events
  5848.                that are present.
  5849.  
  5850.           (D)elete -- This will allow you to delete an undesirable system
  5851.                event from the listing.
  5852.  
  5853.           (I)nsert -- This will insert another event in the list of defined
  5854.                system events.
  5855.  
  5856.           (M)odify -- This will allow you to modify an existing event.
  5857.                More on this command later.
  5858.  
  5859.           (P)osition -- This will move an event from one position to
  5860.                another in the list of events.
  5861.  
  5862.           (Q)uit -- Exits the Event Editor and returns to the point you
  5863.                entered (the WFC menu or the SysOp menu).
  5864.  
  5865.  
  5866.  
  5867.  
  5868.  
  5869.                                    - Page 91 -
  5870.  
  5871.                    PegaSys Main Documentation - Version 0.43
  5872.  
  5873.  
  5874.      When  you  select the (M)odify command, you are asked  to  select  the
  5875.      event  that you would like to modify.  Upon selecting, the event  data
  5876.      is displayed:
  5877.      ______________________________________________________________________
  5878.  
  5879.      Event #1 of 1
  5880.  
  5881.      !. Active     : No
  5882.      1. Description: A NEW PegaSys  Event
  5883.      2. Sched. type: DOS shell
  5884.      3. Event data : event.bat
  5885.      4. Busy time  : 5 minutes
  5886.      5. Exec time  : 00:00
  5887.      6. Busy during: Yes
  5888.      7. Duration   : 1
  5889.      8. Days active: -------
  5890.  
  5891.      Edit menu (?=help) :
  5892.      ______________________________________________________________________
  5893.  
  5894.      The  item numbers and available commands at this screen are  explained
  5895.      in detail below.
  5896.  
  5897.           !    This determines whether or not the event will be executed at
  5898.                the scheduled time.  The default is "no".  If it is toggled
  5899.                to "yes", it acts according to the specifications defined
  5900.                for the event.
  5901.  
  5902.           1    This field describes the event.  Up to 80 characters are
  5903.                allowed, as well as MCI color codes.
  5904.  
  5905.           2    This is the type of event that will be executed.  There are
  5906.                four possibilities, outlined below:
  5907.  
  5908.                     ACS -- These events are regulated by the ACS system.
  5909.                          It is designed to enable only certain callers to
  5910.                          access the BBS at a specified time of the day.
  5911.                          The BBS will prompt for a user name or number, and
  5912.                          if that user number is not defined in the current
  5913.                          ACS event, that user will not be able to log on.
  5914.                          The connection is terminated after a 20 second
  5915.                          "grace period".
  5916.  
  5917.                     Chat -- Not implemented yet.
  5918.  
  5919.                     DOS -- By far, the most common event, this is activated
  5920.                          by performing a shell to the DOS level and
  5921.                          executing files defined in the Event Data (usually
  5922.                          batch files).  Note that this event type should
  5923.                          NOT be used for programs that require a lot of
  5924.                          memory (for example, disk de-fragmenting programs
  5925.                          such as Norton Utilities Speed Disk or PC Tools
  5926.                          Compress).
  5927.  
  5928.                     External -- This requires a batch file for execution,
  5929.                          which is used to detect an ERRORLEVEL value
  5930.  
  5931.  
  5932.                                    - Page 92 -
  5933.  
  5934.                    PegaSys Main Documentation - Version 0.43
  5935.  
  5936.  
  5937.                          (returned upon exiting the BBS) to determine the
  5938.                          operation to be performed.  This will TOTALLY exit
  5939.                          the BBS, using the ERRORLEVEL value defined in the
  5940.                          Event Data field.
  5941.  
  5942.                     Pack -- This event packs the message bases by removing
  5943.                          all deleted messages and adjusting the number of
  5944.                          messages in each base to conform to the maximum
  5945.                          limit set in the message base editor (by removing
  5946.                          old, non-permanent messages).  You should define
  5947.                          AT LEAST ONE packing event; if you don't, your
  5948.                          message bases will "grow out of control"!
  5949.  
  5950.           3    The contents of this field will vary with the type of event
  5951.                being executed:
  5952.  
  5953.                     DOS -- The name of a batch file to be executed when
  5954.                          dropping to DOS, or the name of a program to be
  5955.                          executed.
  5956.  
  5957.                     External -- The ERRORLEVEL value to be used to detect
  5958.                          the type of event to execute.  The value is
  5959.                          restricted to the range 0-255.  (It is recommended
  5960.                          that you do NOT use either 0 or 255.)
  5961.  
  5962.                     ACS -- The ACS requirement that users must satisfy in
  5963.                          order to log on to the BBS.
  5964.  
  5965.                     All others -- Not used; the event data field will be
  5966.                          ignored.
  5967.  
  5968.           4    This is the time prior to an event that the BBS will appear
  5969.                busy.  PegaSys  will take the Exec Time and subtract the
  5970.                Busy Time to determine this value.  When the time is
  5971.                encountered, the modem is taken off-hook using the "modem
  5972.                off-hook" command (defined in the Modem Configuration
  5973.                section in System Configuration), and will remain off-hook
  5974.                until the event time is reached.  Then, depending on the
  5975.                setting of the Busy During field, the modem will either
  5976.                remain off-hook or it will be initialized.  Setting this
  5977.                field to zero (0) allows users to remain online until the
  5978.                exact time of the scheduled event (at which time they are
  5979.                unceremoniously logged off!).
  5980.  
  5981.           5    This is the time of day that the particular scheduled event
  5982.                will occur.  It is defined in both hours and minutes, on a
  5983.                24-hour clock.
  5984.  
  5985.           6    This field determines whether or not the modem will be taken
  5986.                off-hook during the scheduled event (the default is "yes").
  5987.                If the value is "no", the modem will stay on-hook during the
  5988.                event (useful for ACS and Chat events).
  5989.  
  5990.           7    This is a specified time in minutes that will be necessary
  5991.                for the event to occur.  This field will usually be set to
  5992.                one (1) minute.  Unless you know PRECISELY how many minutes
  5993.  
  5994.  
  5995.                                    - Page 93 -
  5996.  
  5997.                    PegaSys Main Documentation - Version 0.43
  5998.  
  5999.  
  6000.                an event will take, you should ALWAYS set this field to 1.
  6001.  
  6002.           8    These are the days of either the regular week, or the whole
  6003.                month, that the scheduled event will occur:
  6004.  
  6005.                     Weekly -- This will occur at least once every single
  6006.                          week.  A bar with the current days active will be
  6007.                          displayed as follows:
  6008.  
  6009.                               Current: SMTWTFS
  6010.  
  6011.                          Modify by entering "X"'s under the days.  If it
  6012.                          is not currently active, typing "X" under the day
  6013.                          will make it active, and vice versa.
  6014.  
  6015.                     Monthly -- This will occur only one day in the month.
  6016.                          The default is the first day of the month.  This
  6017.                          is common for such routines as a hard drive backup
  6018.                          program.
  6019.  
  6020.           [    This will jump back one entry in the list of events.  If it
  6021.                is positioned at the first entry, this command is ignored.
  6022.  
  6023.           ]    This will move forward one entry in the list of events.  If
  6024.                it is positioned at the last entry, this command is ignored.
  6025.  
  6026.           F    This will move to the first entry in the list of events.
  6027.  
  6028.           L    This will move to the last entry in the list of events.
  6029.  
  6030.           J    This will jump to a specified entry in the list of events.
  6031.  
  6032.           Q    Saves all entries in the list of events and returns to the
  6033.                main editor screen.
  6034.  
  6035.  
  6036.  
  6037.  
  6038.  
  6039.  
  6040.  
  6041.  
  6042.  
  6043.  
  6044.  
  6045.  
  6046.  
  6047.  
  6048.  
  6049.  
  6050.  
  6051.  
  6052.  
  6053.  
  6054.  
  6055.  
  6056.  
  6057.  
  6058.                                    - Page 94 -
  6059.  
  6060.                    PegaSys Main Documentation - Version 0.43
  6061.  
  6062.  
  6063.                                    __________
  6064.  
  6065.                                     MINI-DOS
  6066.                                    __________
  6067.  
  6068.  
  6069.      Mini-DOS is a security sensitive DOS shell that is common to many  BBS
  6070.      programs.   It runs as an "internal door" and works according to  that
  6071.      user's  ACS.  Mini-DOS in PegaSys  is usually accessed either via  the
  6072.      WFC  menu  in local access mode, or remotely through the  SysOp  menu.
  6073.      When  Mini-DOS  is  executed, it automatically shells  to  the  AFILES
  6074.      directory  defined in the system configuration.  Upon  execution,  the
  6075.      following appears:
  6076.  
  6077.           Type "EXIT" to return to PegaSys .
  6078.  
  6079.           PegaSys (R) Mini-DOS(R)  Version 2.5
  6080.                    (C)Copyright 1988,89,90 The PegaSys  Team
  6081.  
  6082.           <C:\BBS\AFILES>
  6083.  
  6084.      and you are ready to go to work.
  6085.  
  6086.  
  6087.      -----------------
  6088.      MINI-DOS COMMANDS
  6089.      -----------------
  6090.  
  6091.      The command set that is resident in MiniDOS is as follows:
  6092.  
  6093.           x:        This command is synonymous to DOS' ability to change
  6094.                     between drives being accessed at the DOS level.  For
  6095.                     example, if you are currently in drive C and type "E:",
  6096.                     control will switch to drive E.  This works much the
  6097.                     same as DOS, in that it accepts only logical drives A-E
  6098.                     (or the highest drive specified in the "LASTDRIVE"
  6099.                     parameter of CONFIG.SYS).
  6100.  
  6101.           CD        This works almost the same as the CD (or CHDIR) command
  6102.                     in DOS, in that it enables the user to go to different
  6103.                     paths within the file directory tree.  The only
  6104.                     noticeable difference is that the Mini-DOS CD command
  6105.                     requires a space between the command and the directory
  6106.                     name (i.e., although ".." can be used just like in DOS
  6107.                     to go to the parent directory, you must use "CD .."
  6108.                     instead of "CD..").
  6109.  
  6110.           CLS       Works the same as DOS' CLS command, in that it erases
  6111.                     the current screen and places the prompt at the upper
  6112.                     left corner.
  6113.  
  6114.           COPY      This works almost the same as DOS' COPY command with
  6115.                     the exception that you can't have wildcards appear in
  6116.                     the destination filename.  The copy format is as
  6117.                     follows:
  6118.  
  6119.  
  6120.  
  6121.                                    - Page 95 -
  6122.  
  6123.                    PegaSys Main Documentation - Version 0.43
  6124.  
  6125.  
  6126.                          COPY [destination] 'to' [target]
  6127.  
  6128.                     Thus the following formats are valid:
  6129.  
  6130.                          COPY A:EXAMPLE.TXT D:EXAMPLE.TXT
  6131.                          COPY A:*.* D:
  6132.                          COPY A:*.GIF D:
  6133.  
  6134.           DEL       This will physically erase files from the storage
  6135.                     media, and it acts the same as DOS' internal delete
  6136.                     command and will delete one or more files.  It can
  6137.                     support wildcards, and if the file in question is not
  6138.                     present or has a read only attribute, the following
  6139.                     text will be displayed:
  6140.  
  6141.                          <Filename> Could not delete
  6142.  
  6143.           DIR       This is the same as DOS' DIR command that displays a
  6144.                     listing of files, and it can use wildcard formats,
  6145.                     including "*" and "?".
  6146.  
  6147.           EDIT      This command invokes the internal text editor, which
  6148.                     can be used to edit standard ASCII text or PegaSys
  6149.                     *.MSG files.
  6150.  
  6151.           EXIT      Exits out of Mini-DOS and returns to the WFC menu (or
  6152.                     the BBS if online).
  6153.  
  6154.           EXT       Allows a user with SysOp access to execute an external
  6155.                     DOS command or program.  The syntax is:
  6156.  
  6157.                          EXT <Command>
  6158.  
  6159.                     where <Command> is a DOS command or program executed
  6160.                     exactly the same was as if it were being executed from
  6161.                     DOS itself.  Note that while PegaSys  is loaded, there
  6162.                     is not much memory available to do anything extensive.
  6163.  
  6164.           IFL       Displays a list of files inside an archive file.  The
  6165.                     syntax is:
  6166.  
  6167.                          IFL <Filename>
  6168.  
  6169.                     where <Filename> is the name of an archive file in ARC,
  6170.                     LZH, PAK, ZIP or ZOO format.  If you do not specify a
  6171.                     filename, a help screen will be displayed.
  6172.  
  6173.           MD        This command is the same as the external DOS command,
  6174.                     in that it will make a new directory.
  6175.  
  6176.           MOVE      This command functions the same as COPY, except that
  6177.                     the source files are deleted once they have been copied
  6178.                     to their destination.
  6179.  
  6180.           RD        This command is the same as the external DOS command,
  6181.                     in that it will remove a directory (as long as it is
  6182.  
  6183.  
  6184.                                    - Page 96 -
  6185.  
  6186.                    PegaSys Main Documentation - Version 0.43
  6187.  
  6188.  
  6189.                     empty, and no files or directories are contained within
  6190.                     it).
  6191.  
  6192.           REN       This is the same as the external DOS command that will
  6193.                     rename a file or a wildcard of files to a different
  6194.                     filename(s).
  6195.  
  6196.           SEND      Enables a high security level user to download files
  6197.                     (usually BBS or DOS related) not present on the system,
  6198.                     that may be essential. The caller will enter "SEND
  6199.                     filename" and choose a file transfer protocol to use to
  6200.                     download the file.  The file is then transferred and
  6201.                     the Mini-DOS prompt will return.
  6202.  
  6203.           TYPE      This command operates almost exactly the same as DOS'
  6204.                     TYPE command, except that (1) the display will pause
  6205.                     when it has filled according to the user's setup, and
  6206.                     (2) if a *.MSG file is displayed that contains MCI
  6207.                     color codes, the file will be displayed in color (or
  6208.                     not, again according to the user's setup).
  6209.  
  6210.           VER       Displays information about the current version of Mini
  6211.                     DOS and PegaSys  being used.  For example, Mini-DOS for
  6212.                     version 2.5 displays the following text:
  6213.  
  6214.                     PegaSys (R) MiniDos(R)  Version 2.5
  6215.                                 (C)Copyright 1988,89,90 The PegaSys  Team
  6216.  
  6217.           ?         Displays a list of all available Mini-DOS commands.
  6218.  
  6219.  
  6220.      ------------------------
  6221.      THE MINI-DOS TEXT EDITOR
  6222.      ------------------------
  6223.  
  6224.      PegaSys   has a special built in text editor that can be used to  edit
  6225.      standard ASCII text files or PegaSys  *.MSG files.  This editor  works
  6226.      similarly to DOS' EDLIN text editor, in that it works on one line at a
  6227.      time.
  6228.  
  6229.      Upon  entering  the text editor (either from the WFC menu  or  through
  6230.      Mini-DOS), you are given a command line and must enter the name of the
  6231.      file you wish to edit.  The default path is your AFILES directory, and
  6232.      when  you request help in the text editor, by pressing "?" for a  list
  6233.      of commands, you are presented with the following menu:
  6234.  
  6235.           (+)Forward line    (-)Back line
  6236.           (T)op              (B)ottom
  6237.           (P)rint line       (L)ist
  6238.           (I)nsert lines     (D)elete lines
  6239.           (R)eplace line     (C)lear all
  6240.           (Q)uit (abort)     (S)ave
  6241.           (*)Center line
  6242.  
  6243.  
  6244.  
  6245.  
  6246.  
  6247.                                    - Page 97 -
  6248.  
  6249.                    PegaSys Main Documentation - Version 0.43
  6250.  
  6251.  
  6252.      These commands are explained below:
  6253.  
  6254.           (+)Forward line -- Will move the current line of editing up one
  6255.                in position, unless it is at the end, then it will say [end
  6256.                line].  For example, if you are currently editing line
  6257.                number 5 and at the ":" prompt, you hit a "+", you are moved
  6258.                to line 6 of the text.
  6259.  
  6260.           (-)Back line -- Moves the current text being edited back one in
  6261.                position, unless at the beginning in which case it will
  6262.                automatically stay at line 1.
  6263.  
  6264.           (T)op -- Automatically moves the line being edited from the
  6265.                current one to line 1.
  6266.  
  6267.           (B)ottom -- Automatically moves the line being edited from the
  6268.                current one to the last line of the text.
  6269.  
  6270.           (P)rint line -- Display the current line.
  6271.  
  6272.           (L)ist -- Will list the line being edited and all subsequent
  6273.                lines in the file.  Therefore, if you have a 26 line text
  6274.                file, and are currently editing line 6, the list will be
  6275.                from 6 to 26.
  6276.  
  6277.           (I)nsert lines -- Enables you to insert lines either blank or
  6278.                containing text, until you type "." at the beginning of a
  6279.                line to save the file.
  6280.  
  6281.           (D)elete lines -- Enables you to delete the current line being
  6282.                edited in the file.
  6283.  
  6284.           (R)eplace lines -- In the event you wish to replace lines, this
  6285.                command will show the original line and then provides a
  6286.                blank line for changes and alterations.
  6287.  
  6288.           (C)lear all -- Clears the screen and makes the file in memory
  6289.                appear blank.  Basically, used ONLY when a file has been
  6290.                damaged so bad, there is no salvaging it.
  6291.  
  6292.           (Q)uit (abort) -- Used to abort the edit.  Does NOT save the file
  6293.                in memory to disk.  Used when you made a mistake and decide
  6294.                that the previous version of the file was better. Returns
  6295.                you to the point of entry (the WFC menu, the BBS, or Mini-
  6296.                DOS).
  6297.  
  6298.           (S)ave -- Used to save the file in memory to disk, then it will
  6299.                exit and return to the point of entry (the WFC menu, the
  6300.                BBS, or Mini-DOS).
  6301.  
  6302.           (*)Center line -- This command will center the line being edited.
  6303.                Be careful with this command; since it does not remove any
  6304.                previous centering code, you could end up "stacking"
  6305.                multiple centering codes on the line (making it look not at
  6306.                all like you want!).
  6307.  
  6308.  
  6309.  
  6310.                                    - Page 98 -
  6311.  
  6312.                    PegaSys Main Documentation - Version 0.43
  6313.  
  6314.  
  6315.                       ___________________________________
  6316.  
  6317.                        THE INFOFORM QUESTIONNAIRE SYSTEM
  6318.                       ___________________________________
  6319.  
  6320.  
  6321.      The  InfoForm questionnaire system is one of PegaSys 's most  powerful
  6322.      information-gathering   features.   Using  just  a  few  commands   --
  6323.      scattered in an ordinary text file -- the SysOp can gather volumes  of
  6324.      information  about  users:  Who they are, what they  want,  what  they
  6325.      DON'T  want.   The  uses for the  InfoForm  questionnaire  system  are
  6326.      virtually endless.
  6327.  
  6328.  
  6329.      -------------------------------------------
  6330.      HOW INFOFORM QUESTIONNAIRES ARE CONSTRUCTED
  6331.      -------------------------------------------
  6332.  
  6333.      InfoForm questionnaires are really nothing more than plain text  files
  6334.      with certain commands, meaningful only to the InfoForm system,  placed
  6335.      throughout.   Think of the InfoForm system as a miniature  batch  file
  6336.      language, but whose emphasis is placed on user input.
  6337.  
  6338.      The  InfoForm  questionnaire is stored in the AFILES directory,  in  a
  6339.      file  with  the extension ".INF".  When users  answer  the  questions,
  6340.      their answers are also stored in the AFILES directory, in a file  with
  6341.      the  same  name as the InfoForm questionnaire but with  the  extension
  6342.      ".ASW" (for "AnSWers").  Answers from different users are appended  to
  6343.      the  end of the *.ASW file; thus, you have a complete record  of  each
  6344.      user's responses (until you delete the *.ASW file).
  6345.  
  6346.  
  6347.      --------------------------
  6348.      THE NEW USER QUESTIONNAIRE
  6349.      --------------------------
  6350.  
  6351.      A special InfoForm questionnaire, if present, is always given to a new
  6352.      user during the new user logon process.  The file is NEWUSER.INF, with
  6353.      the answers stored in NEWUSER.ASW.  Like all InfoForm  questionnaires,
  6354.      NEWUSER.INF can contain any questions you like; however, the new  user
  6355.      questionnaire  is  usually  used to  ask  for  additional  information
  6356.      (information  that  isn't requested during the normal new  user  logon
  6357.      process).  Answers to the new user questionnaire can be read from  the
  6358.      user editor, or through a menu command (discussed below).
  6359.  
  6360.  
  6361.      ------------------------------------------
  6362.      ASKING AND READING INFOFORM QUESTIONNAIRES
  6363.      ------------------------------------------
  6364.  
  6365.      Constructing  a command to ask an InfoForm questionnaire is  simply  a
  6366.      matter  of  adding a new command to a menu.  The  command  should  use
  6367.      Cmdkeys "-Q", with the InfoForm questionnaire filename in the  MString
  6368.      field.  For example:
  6369.  
  6370.  
  6371.  
  6372.  
  6373.                                    - Page 99 -
  6374.  
  6375.                    PegaSys Main Documentation - Version 0.43
  6376.  
  6377.  
  6378.           Long descript :(Q)uestionnaire - Ask user some questions
  6379.           Short descript:(Q)uestionnaire
  6380.           Cmd letters   :Q
  6381.           ACS required  :"s20"
  6382.           Cmdkeys       :-Q
  6383.           MString       :question.inf
  6384.           Flags         :None
  6385.  
  6386.      Reading an InfoForm answer file is just as easy.  Construct a  command
  6387.      using  Cmdkeys "-R", with the InfoForm questionnaire filename  in  the
  6388.      MString field:
  6389.  
  6390.           Long descript :(R)ead Answers - Read answers to questionnaire
  6391.           Short descript:(R)ead Answers
  6392.           Cmd letters   :R
  6393.           ACS required  :"s20"
  6394.           Cmdkeys       :-R
  6395.           MString       :question.inf
  6396.           Flags         :None
  6397.  
  6398.      Alternately,  you could leave the MString field blank, in  which  case
  6399.      PegaSys   will prompt you for the InfoForm questionnaire  filename  in
  6400.      which to read the answers.
  6401.  
  6402.  
  6403.      -------------------------------
  6404.      INFOFORM QUESTIONNAIRE COMMANDS
  6405.      -------------------------------
  6406.  
  6407.      Below  are  listed all the InfoForm questionnaire  commands  currently
  6408.      supported  by PegaSys .  All commands must start on a  separate  line,
  6409.      beginning  with a ";" (semicolon) character.  Labels (used by the  "G"
  6410.      and  "I"  commands)  start on a separate line, beginning  with  a  ":"
  6411.      (colon)  character and followed by a string of  characters.   Anything
  6412.      else is treated as displayable text.
  6413.  
  6414.           Command:  A<string>*
  6415.           Function: Upper and lower case string input.  Displays <string>,
  6416.                     then inputs the string at the "*" character.  NOTE:
  6417.                     All characters after the "*" character are completely
  6418.                     ignored!
  6419.  
  6420.           Command:  B<string>*
  6421.           Function: Similar to the "A" command, except all input is upper
  6422.                     case only.
  6423.  
  6424.           Command:  C"chars"<string>*
  6425.           Function: Multiple-choice input.  Displays string, then inputs
  6426.                     a single character at the "*" character.  Accepted
  6427.                     answers are any character between the quote marks ("").
  6428.  
  6429.           Command:  Dx<string>
  6430.           Function: Open door.  Outputs a door file (depending on "x"),
  6431.                     then executes <string>.  All rules for standard door
  6432.                     commands apply (refer to the menu documentation).
  6433.                     Allowable values for "x":
  6434.  
  6435.  
  6436.                                    - Page 100 -
  6437.  
  6438.                    PegaSys Main Documentation - Version 0.43
  6439.  
  6440.  
  6441.                          -    None (no door file written)
  6442.                          C    CHAIN.TXT (WWIV)
  6443.                          D    DORINFO1.DEF (RBBS-PC)
  6444.                          G    DOOR.SYS (GAP)
  6445.                          S    SFDOORS.DAT (Spitfire)
  6446.                          W    CALLINFO.BBS (Wildcat!)
  6447.  
  6448.           Command:  G<label>
  6449.           Function: Goto statement.  Returns to beginning of file and
  6450.                     searches for the first label of <label>.  If none
  6451.                     exists, the end of the questionnaire file is reached
  6452.                     and the questionnaire completes.
  6453.  
  6454.           Command:  H
  6455.           Function: Hang up.  Terminate questionnaire and hang up on user.
  6456.  
  6457.           Command:  I<string>,<label>
  6458.           Function: Conditional goto statement.  Branches to <label> if
  6459.                     <string> was the last value input from a "A", "B", "C",
  6460.                     or "Y" command.  No distinction is made between upper
  6461.                     and lower case.
  6462.  
  6463.           Command:  K
  6464.           Function: Abort.  Terminate questionnaire without saving answers
  6465.                     in answer file.
  6466.  
  6467.           Command:  L<string>
  6468.           Function: Outputs <string> to the questionnaire answer file, but
  6469.                     not to the user's display.
  6470.  
  6471.           Command:  Q
  6472.           Function: Quit.  Terminate questionnaire and save answers in
  6473.                     answer file.
  6474.  
  6475.           Command:  T<filename>
  6476.           Function: Displays the file <filename>.
  6477.  
  6478.           Command:  Y<string>*
  6479.           Function: Yes or No question.  Displays <string>, then accepts
  6480.                     either a "Y" for Yes, or an "N" for No, at the "*"
  6481.                     character.
  6482.  
  6483.           Command:  ;<string>
  6484.           Function: Comment.  It is neither displayed, nor output to the
  6485.                     questionnaire answer file.
  6486.  
  6487.  
  6488.      -------------------------------
  6489.      A SAMPLE INFOFORM QUESTIONNAIRE
  6490.      -------------------------------
  6491.  
  6492.      Below  is listed a small InfoForm questionnaire as an example of  what
  6493.      the InfoForm system can do.  This questionnaire is suitable for use as
  6494.      a new user questionnaire (NEWUSER.INF); with a little modification, it
  6495.      can be enhanced to ask whatever questions you wish.
  6496.  
  6497.  
  6498.  
  6499.                                    - Page 101 -
  6500.  
  6501.                    PegaSys Main Documentation - Version 0.43
  6502.  
  6503.  
  6504.           Okay... just one more series of questions to answer, and then
  6505.           you'll be on your way!  It is essential for validation purposes
  6506.           and security measures that you answer the following questions
  6507.           as completely and accurately as possible.  There are no trick
  6508.           questions, so don't worry... it's not a test!
  6509.  
  6510.           ;AAbout how long have you been BBSing? *
  6511.           ;YAre you a SysOp of any BBS? (Y/N) : *
  6512.           ;INO,NOSYSOP
  6513.  
  6514.           Enter the BBS number in the following format:
  6515.  
  6516.             ###-###-####
  6517.           ;A: *
  6518.  
  6519.           Now enter the BBS name:
  6520.  
  6521.             -BBS-Name---------------------------------------------------
  6522.           ;A: *
  6523.  
  6524.           ;AWhat type of BBS software do you run? *
  6525.           ;AHow long has your BBS been running for? *
  6526.           ;GNOSYSOP1
  6527.  
  6528.           :NOSYSOP
  6529.           Oh well, someone's gotta do it, eh!
  6530.  
  6531.           :NOSYSOP1
  6532.           Do you know any of the current users on this BBS, or any other
  6533.           good users that could recommend you?  (2 lines)
  6534.  
  6535.            1: *
  6536.            2: *
  6537.  
  6538.           Well, that completes our little survey.  Hope it wasn't too
  6539.           painful!
  6540.  
  6541.  
  6542.  
  6543.  
  6544.  
  6545.  
  6546.  
  6547.  
  6548.  
  6549.  
  6550.  
  6551.  
  6552.  
  6553.  
  6554.  
  6555.  
  6556.  
  6557.  
  6558.  
  6559.  
  6560.  
  6561.  
  6562.                                    - Page 102 -
  6563.  
  6564.                    PegaSys Main Documentation - Version 0.43
  6565.  
  6566.  
  6567.                                _________________
  6568.  
  6569.                                 RUN-TIME ERRORS
  6570.                                _________________
  6571.  
  6572.  
  6573.      Certain  errors  at  run  time cause PegaSys  to  exit  back  to  DOS.
  6574.      Whenever  this  occurs, the ENTIRE screen image is output  to  a  file
  6575.      called "ERR.LOG" in your main BBS directory, along with certain pieces
  6576.      of  vital  information such as time, date, error number,  BBS  version
  6577.      number, the user who was on and what baud rate they were on at.
  6578.  
  6579.      Here is what each screen image entry LOOKS like in ERR.LOG:
  6580.  
  6581.           RT #XXX at MM/DD/YY HH:MM:SS  BBS-Ver: 1.7b Standard
  6582.           User "BLACK ADEPT #1" was on at 2400 baud
  6583.  
  6584.      after  which  follows the "picture" of the screen at the time  of  the
  6585.      error.
  6586.  
  6587.      Also,  a  message is output to the SysOp log, and the  user's  screen,
  6588.      when a run-time error occurs.  This is output to the SysOp log:
  6589.  
  6590.           *>> Runtime error XXX at MM/DD/YY HH:MM:SS <<*
  6591.           (Check ERR.LOG in main BBS dir)
  6592.  
  6593.      and this is output to the user's screen:
  6594.  
  6595.           *>> System error occurred at MM/DD/YY HH:MM:SS <<*
  6596.  
  6597.      Note  that WHENEVER a run-time error occurs, it is a bug in  PegaSys .
  6598.      PegaSys   is NOT supposed to have run-time errors in it.  Please  note
  6599.      the information at the top of the ERR.LOG file:
  6600.  
  6601.           Critical Error Log file - Contains screen images at instant of
  6602.           Error.  The "X" character shows the cursor position at time of
  6603.           error.  Note: You may periodically delete this file with no harm
  6604.           to the system, but note the following information:
  6605.  
  6606.           Please notify Eric Oman that you have encountered a Critical
  6607.           Error.  You will need to send this file to him, along with a
  6608.           short message stating - briefly - what events led up to the
  6609.           Critical Error, and whether or not the error was repeatable, and
  6610.           under what circumstances.
  6611.  
  6612.      The  run-time errors are divided into four categories:  DOS errors  1-
  6613.      99;  I/O errors, 100-149; critical errors, 150-199; and fatal  errors,
  6614.      200-255.   Please remember that run-time errors should  NEVER  HAPPEN!
  6615.      When  they  do, it is an indication that something in  the  BBS  isn't
  6616.      working correctly.
  6617.  
  6618.      The following is a listing of all run-time errors.  You might be  able
  6619.      to figure out the problem, and correct it, by referring to this  list.
  6620.      If  you can't, don't get discouraged.  Just call one of the  Alpha  or
  6621.      Beta  sites  near you, and they'll be happy to help  you  through  any
  6622.      problem you might encounter.
  6623.  
  6624.  
  6625.                                    - Page 103 -
  6626.  
  6627.                    PegaSys Main Documentation - Version 0.43
  6628.  
  6629.  
  6630.      ----------
  6631.      DOS ERRORS
  6632.      ----------
  6633.  
  6634.      2 File not found.
  6635.      3 Path not found.
  6636.      4 Too many open files.
  6637.  
  6638.           This error may indicate that you do NOT have a FILES=xx entry in
  6639.           your CONFIG.SYS file.  You should have the following lines in
  6640.           your CONFIG.SYS file:
  6641.  
  6642.                BUFFERS=40
  6643.                FILES=30
  6644.  
  6645.      5 File access denied.
  6646.      6 Invalid file handle.
  6647.  
  6648.           This error is reported if an invalid file handle is passed to a
  6649.           DOS system call.  It should never occur; if it does, it is an
  6650.           indication that the file variable is somehow trashed.  This may
  6651.           come about if you edit a file that has been opened by PegaSys .
  6652.  
  6653.      12 Invalid file access code.
  6654.      15 Invalid drive number.
  6655.      16 Cannot remove current directory.
  6656.      17 Cannot rename across drives.
  6657.  
  6658.  
  6659.      ----------
  6660.      I/O ERRORS
  6661.      ----------
  6662.  
  6663.      100 Disk read error.
  6664.  
  6665.           Reported if PegaSys  attempts to read past the end of a file.
  6666.  
  6667.      101 Disk write error.
  6668.  
  6669.           Reported if the disk becomes full.
  6670.  
  6671.      102 File not assigned.
  6672.      103 File not open.
  6673.      104 File not open for input.
  6674.      105 File not open for output.
  6675.      106 Invalid numeric format.
  6676.  
  6677.  
  6678.      ---------------
  6679.      CRITICAL ERRORS
  6680.      ---------------
  6681.  
  6682.      These  errors usually indicate a hardware problem.  Double-check  your
  6683.      system for faults (especially your hard and/or floppy disks).
  6684.  
  6685.      150 Disk is write-protected.
  6686.  
  6687.  
  6688.                                    - Page 104 -
  6689.  
  6690.                    PegaSys Main Documentation - Version 0.43
  6691.  
  6692.  
  6693.      151 Unknown unit.
  6694.      152 Drive not ready.
  6695.      153 Unknown command.
  6696.      154 CRC error in data.
  6697.      155 Bad drive request structure length.
  6698.      156 Disk seek error.
  6699.      157 Unknown media type.
  6700.      158 Sector not found.
  6701.      159 Printer out of paper.
  6702.      160 Device write fault.
  6703.      161 Device read fault.
  6704.      162 Hardware failure.
  6705.  
  6706.  
  6707.      ------------
  6708.      FATAL ERRORS
  6709.      ------------
  6710.  
  6711.      These errors always immediately terminate the program.
  6712.  
  6713.      200 Division by zero.
  6714.      201 Range check error.
  6715.      202 Stack overflow error.
  6716.      203 Heap overflow error.
  6717.      204 Invalid pointer operation.
  6718.      205 Floating point overflow.
  6719.      206 Floating point underflow.
  6720.      207 Invalid floating point operation.
  6721.      208 Overlay manager not installed.
  6722.      209 Overlay file read error.
  6723.  
  6724.           If you run Norton Utilities Speed Disk or PC Tools Compress (or
  6725.           some other hard disk organizer/defragmenter) as an event, and run
  6726.           it as a DOS Shell event, this error can occur sometimes, because
  6727.           Speed Disk/Compress will probably move the BBS.OVR file somewhere
  6728.           else.  The solution is to run Speed Disk/Compress as an
  6729.           "External" event.  (Any program of that nature should be run as
  6730.           an "External" event  anyway, to give them all the memory they
  6731.           want to operate!)
  6732.  
  6733.  
  6734.  
  6735.  
  6736.  
  6737.  
  6738.  
  6739.  
  6740.  
  6741.  
  6742.  
  6743.  
  6744.  
  6745.  
  6746.  
  6747.  
  6748.  
  6749.  
  6750.  
  6751.                                    - Page 105 -
  6752.  
  6753.             -------------------
  6754.             REGISTERING PEGASYS
  6755.          -------------------
  6756.  
  6757.  
  6758.             The Registration Rates Are As Follows :
  6759.  
  6760.             Standard - $45.95
  6761.             Commercial - $75.95
  6762.  
  6763.             send check or money order to the following address :
  6764.  
  6765.             CompuMark Technology
  6766.             ATTN: Andy Miffleton
  6767.             521 Parkview
  6768.             Burleson, Tx
  6769.             76028
  6770.  
  6771.  
  6772.             Thanks For trying PegaSys!!
  6773.